Claude API로 Roo Code 무제한 사용

Roo Code는 VS Code용 강력한 에이전트 기반 코딩 확장 프로그램으로, 역할을 Architect, Code, Debug, Ask라는 개별 작업 모드로 나눕니다. 각 모드에는 자체 모델, temperature, 공급자 설정을 적용할 수 있습니다. Orchestrator 기능은 하위 작업을 생성해 API 사용량을 크게 늘립니다. Roo Code를 정액제 무제한 Claude 게이트웨이에 연결하면 Architect 모드에 Opus를, Code 모드에 Sonnet을 할당하고, 오케스트레이션된 워크플로의 비용이 누적되는 것을 걱정하지 않아도 됩니다.

Roo Code가 API 사용량을 크게 늘리는 방식

Roo Code의 아키텍처는 단순한 채팅 기반 AI 편집기와 근본적으로 다릅니다. 각 작업 모드(Architect, Code, Debug, Ask)는 자체 컨텍스트를 유지하며 서로 다른 모델을 할당할 수 있습니다. Orchestrator 모드가 활성화되면 복잡한 작업을 하위 작업으로 나누고 각각을 적절한 모드에 위임합니다. 사실상 각각 자체 토큰 예산을 독립적으로 사용하는 병렬 대화를 생성하는 셈입니다.

'인증 모듈 리팩터링'과 같은 단일 Orchestrator 작업은 새로운 구조를 계획하는 Architect 하위 작업, 서로 다른 구성 요소를 구현하는 Code 하위 작업 세 개, 결과를 검증하는 Debug 하위 작업을 생성할 수 있습니다. 각 하위 작업에는 자체 시스템 프롬프트, 도구 정의, 대화 기록이 포함됩니다. 전체 토큰 사용량은 단순히 더해지는 것이 아니라 배수로 늘어납니다. 각 하위 작업이 전체 컨텍스트를 주입받아 새로 시작하기 때문입니다.

Roo Code가 네이티브 도구 호출만 사용한다는 점은 이 현상을 더욱 심화합니다. 네이티브 호출이 실패하면 XML 기반 도구 호출로 전환하는 일부 에이전트와 달리, Roo Code는 API의 네이티브 함수 호출 지원을 요구합니다. 각 도구 호출(파일 읽기, 쓰기, 터미널 명령)은 구조화된 도구 호출과 응답의 쌍으로 이루어져 모든 상호작용에 오버헤드를 더합니다. 모드별 모델, Orchestrator 하위 작업, 네이티브 도구 호출이 결합되어 Roo Code는 VS Code 생태계에서 API 사용량이 가장 많은 도구 중 하나가 됩니다.

API 설정 프로필 구성하기

Roo Code는 공급자 설정을 API 설정 프로필로 관리합니다. 각 프로필에는 공급자 유형, 기본 URL, API 키, 모델 식별자와 함께 temperature, 사고 예산 같은 선택적 매개변수가 포함됩니다. VS Code에서 Roo Code 설정 패널을 열고 API 설정으로 이동하세요. 새 프로필 만들기를 클릭해 시작하세요.

Anthropic 공급자 방식을 사용하는 경우 공급자를 Anthropic으로 설정하고, 기본 URL에 https://unlimited.aiprimetech.io을 입력한 뒤(루트 호스트만 입력하고 /v1은 제외하세요. Anthropic SDK가 경로를 덧붙입니다), AI Prime Tech Unlimited 키를 붙여 넣으세요. 균형 잡힌 프로필에는 claude-sonnet-4-5을, 최대 추론 성능에는 claude-opus-4-6를 모델로 선택하세요. 결정론적 결과와 창의성 중 어느 쪽을 선호하는지에 따라 temperature를 0에서 1 사이로 설정하세요.

상황별로 여러 프로필을 만드세요. 빠른 질문에는 Haiku를 사용하는 빠른 프로필, 일상적인 코딩에는 Sonnet을 사용하는 표준 프로필, 아키텍처 결정에는 Opus를 사용하는 고성능 프로필을 구성할 수 있습니다. 다음 단계에서 이러한 프로필을 특정 모드에 할당하므로 이름을 명확하게 지정하세요(예: 'Unlimited-Sonnet', 'Unlimited-Opus').

모드별 모델 할당 전략

무제한 요금제 사용자에게 Roo Code의 핵심 기능은 모드별 모델 할당입니다. 설정에서 각 모드(Architect, Code, Debug, Ask)에는 사용할 API 설정 프로필을 선택하는 드롭다운이 있습니다. 무제한 요금제에서는 모델을 적극적으로 배치하는 전략이 가장 좋습니다. 깊이 있는 추론이 가장 중요한 Architect 및 Debug 모드에는 Opus를, 속도와 처리량이 우선인 Code 및 Ask 모드에는 Sonnet을 할당하세요.

Architect 모드는 실행 전에 복잡한 변경 사항을 계획합니다. 시스템 전반에 미치는 영향, 의존성 연결 관계, 아키텍처 패턴을 추론하는 Opus의 뛰어난 능력이 이 모드에 큰 도움이 됩니다. Debug 모드 역시 Opus의 이점을 누립니다. 버그를 진단하려면 여러 가설을 동시에 고려하고 실행 경로를 따라 추론해야 하는 경우가 많기 때문입니다.

Code 모드는 실제 파일 편집을 처리하며 가장 자주 호출됩니다. Sonnet은 빠른 피드백 주기를 유지하면서도 고품질 코드를 생성할 만큼 충분히 빠릅니다. Ask 모드는 간단한 질문과 설명을 위한 모드이며, Sonnet은 이러한 작업을 효율적으로 처리합니다. 무제한 요금제에서는 모든 모드에 Opus를 사용해도 추가 비용이 없지만, 대화형 워크플로에서는 지연 시간의 차이가 중요합니다. 이렇게 나누면 중요한 작업에는 깊이 있는 추론을, 속도가 중요한 작업에는 빠른 응답을 제공하여 두 모델의 장점을 모두 얻을 수 있습니다.

Orchestrator와 Boomerang 하위 작업

Orchestrator 모드(Boomerang이라고도 함)는 Roo Code의 작업 분해 엔진입니다. Orchestrator 모드에서 복잡한 작업을 설명하면 작업을 개별 하위 작업으로 나누고 각각을 적절한 모드에 위임합니다. 하위 작업의 결과는 '부메랑'처럼 Orchestrator로 돌아오며, Orchestrator는 이를 종합하고 다음 단계를 결정합니다.

각 하위 작업은 자체 토큰 예산을 사용하는 별도의 대화 컨텍스트에서 실행됩니다. 즉, 단일 Orchestrator 작업이 서로 다른 Claude 대화 다섯 개를 생성하고, 각 대화가 독립적으로 수만 개의 토큰을 사용할 수 있습니다. 토큰별 과금 방식에서는 중간 정도로 복잡한 기능을 위한 Orchestrator 세션에 수 달러의 비용이 쉽게 발생할 수 있습니다. 무제한 요금제에서는 단일 채팅 메시지와 비용이 정확히 같습니다. 추가 비용이 없습니다.

무제한 액세스로 Orchestrator를 효과적으로 사용하려면 제약을 두지 마세요. 문제 해결에 필요한 만큼 하위 작업을 생성하도록 하세요. 각 단계마다 확인을 요청하지 않고 Orchestrator가 작업 분할을 결정하는 자동 모드를 활성화하세요. 이렇게 하면 Orchestrator가 자유롭게 반복 작업을 수행하고, 진행 중에 새로운 정보를 발견할 때마다 하위 작업을 다시 계획하고 실행할 수 있어 더 나은 결과를 얻을 수 있습니다.

.roomodes로 사용자 지정 모드 만들기

Roo Code는 프로젝트 루트의 .roomodes 파일에 정의된 프로젝트 수준의 사용자 지정 모드를 지원합니다. 각 사용자 지정 모드에는 이름, 설명, 시스템 프롬프트에 추가할 내용, 허용 도구, 사용할 API 구성 프로필이 지정됩니다. 이를 통해 프로젝트에 특화된 에이전트를 만들 수 있습니다. 예를 들어 SQL 파일과 마이그레이션 도구에만 접근할 수 있는 '데이터베이스 마이그레이션' 모드나, 글쓰기에 최적화된 프롬프트로 Markdown 작업에 집중하는 '문서화' 모드를 만들 수 있습니다.

프로젝트 루트에 .roomodes JSON 파일을 만드세요. 각 모드 항목에는 roleDefinition(시스템 프롬프트), allowedTools(모드에서 사용할 수 있는 도구 이름의 배열), apiConfiguration(사용할 프로필)이 포함됩니다. 사용자 지정 모드는 모드 선택기에 기본 제공 모드와 함께 표시됩니다.

무제한 요금제에서는 사용자 지정 모드를 통해 창의적인 워크플로 패턴을 구현할 수 있습니다. 익숙하지 않은 코드베이스를 심층 분석할 때 Opus를 사용하는 '리서치' 모드를 만드세요. 간단한 한 줄 수정에 Haiku를 사용하는 '빠른 수정' 모드를 만드세요. 코드를 수정하지 않고 읽고 피드백을 제공하는 '검토' 모드를 만드세요. 정액 요금제이므로 설정을 잘못했을 때 발생하는 비용을 걱정하지 않고 모드 구성을 자유롭게 실험할 수 있습니다.

네이티브 도구 호출 요구 사항

Roo Code는 네이티브 함수 호출만 사용하며, 일부 다른 에이전트처럼 XML 기반 도구 호출로 대체하지 않습니다. 따라서 API 제공업체는 여러 턴에 걸친 tool_use 및 tool_result 블록을 포함하여 Messages API의 tools 매개변수를 올바르게 지원해야 합니다. AI Prime Tech Unlimited 게이트웨이는 모든 Claude 모델에서 이를 완벽하게 지원합니다.

도구 호출 오류가 발생한다면 거의 항상 두 가지 문제 중 하나가 원인입니다. 도구 호출 지원이 부족한 이전 모델 버전을 사용하거나, 기본 URL을 잘못 구성하여 요청이 잘못된 엔드포인트로 전달되는 경우입니다. 프로필의 모델 식별자가 최신 Claude 모델과 일치하는지, 기본 URL이 선택한 제공업체 유형에 맞는지 확인하세요.

Roo Code의 도구에는 파일 작업(읽기, 쓰기, 목록 조회), 터미널 명령(실행, 출력 읽기), 브라우저 작업(활성화한 경우), MCP 도구(구성한 경우)가 포함됩니다. 각 도구 호출은 대화에 구조화된 데이터를 추가하며, 일반적으로 결과를 포함해 도구 호출당 200-500 토큰이 사용됩니다. 수십 번의 도구 호출이 필요한 복잡한 작업에서는 이 양이 상당히 누적됩니다.

Roo Code 구성 문제 해결

가장 흔한 문제는 모드와 프로필의 불일치입니다. 프로필을 만들었지만 모드에 할당하는 것을 잊은 경우입니다. 설정에서 각 모드의 API 구성 드롭다운을 확인하세요. '기본값'으로 표시되어 있는데 기본 프로필을 설정하지 않았다면 요청이 실패합니다. 사용할 각 모드에 프로필을 명시적으로 할당하세요.

모드를 직접 사용할 때는 정상적으로 작동하지만 Orchestrator의 하위 작업이 실패한다면, 별도로 명시적인 구성을 하지 않은 하위 작업 모드가 Orchestrator의 프로필을 상속하기 때문인 경우가 많습니다. Orchestrator가 호출할 수 있는 각 모드에 유효한 프로필이 개별적으로 할당되어 있는지 확인하세요. 일반적인 구성 방식은 기본 프로필을 Sonnet 구성으로 설정하고 Architect와 Debug만 Opus로 재정의하는 것입니다.

긴 Orchestrator 세션에서 연결 시간 초과 오류가 발생한다면, 보통 너무 많은 하위 작업이 동시에 실행되어 호출 한도에 도달했다는 뜻입니다. 게이트웨이는 초과 요청을 대기열에 넣고 처리 가능한 시점에 응답을 반환하지만, VS Code는 이 지연을 시간 초과로 판단할 수 있습니다. 이 문제가 반복된다면 설정에서 Orchestrator의 동시 실행 수를 줄이거나 잠시 기다리세요. 게이트웨이는 공정 사용 한도 내에서 결국 모든 요청을 처리합니다.

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-opus-4-6
#
# Mode Assignment:
#   Architect -> Unlimited-Opus
#   Code      -> Unlimited-Sonnet
#   Debug     -> Unlimited-Opus
#   Ask       -> Unlimited-Sonnet

자주 묻는 질문

AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.