지식 기반 섹션 ▾

내비게이션

▸ 여기서 시작하세요 역할별

카테고리

도구 32
용어집 12

도구

Roo Code + Gonka AI — VS Code용 자율 AI 에이전트

Roo Code는 VS Code용 자율 AI 에이전트입니다. 파일을 읽고 편집하고, 터미널에서 명령을 실행하고, 브라우저와 상호 작용하며 다단계 개발 작업을 완료합니다. 이는 Cline의 포크이며, 다음과 같은 기능으로 더 발전했습니다: 사용자 정의 작업 모드(Architect, Code, Ask, Debug 및 커스텀 모드), 프로젝트별 사용자 정의 지침, 유연한 모델 구성 패널. 본질적으로 편집기 내부에 AI 전문가 팀 전체가 있습니다.

이러한 에이전트의 주요 문제는 토큰 소비입니다. Roo Code는 한 작업을 위해 파일 컨텍스트, 명령 출력, 도구 결과 등 수천만 개의 토큰을 처리합니다. Anthropic의 가격($3-15/1M)으로 보면, 한 번의 전체 세션은 $30-1500에 달합니다. 이는 일상적인 작업에 비현실적입니다.

JoinGonka Gateway는 비용을 수천 배 절감합니다. 동일한 세션은 $0.01-1.00이면 됩니다. Gateway는 분산형 Gonka 네트워크의 추론을 재판매하며, OpenAI 형식('OpenAI Compatible' 제공자)과 Anthropic 형식(엔드포인트 /v1/messages)을 모두 지원합니다. Roo Code는 두 가지 중 하나를 통해 연결됩니다. 이는 Roo Code를 비싼 데모에서 매일 사용할 수 있는 작업 도구로 변모시킵니다.

1단계: Roo Code 설치 및 키 받기

Roo Code 설치: VS Code에서 확장(Ctrl/Cmd+Shift+X)을 열고 'Roo Code'를 검색하여 설치를 클릭합니다. 설치 후 사이드바에 Roo Code 캥거루 아이콘이 나타납니다.

JoinGonka API 키: 아직 키가 없으면 gate.joingonka.ai/register에 등록하여 10M 무료 토큰을 받고 대시보드에서 jg- 접두사가 붙은 키를 생성하세요.

2단계: Roo Code 구성 (OpenAI Compatible)

가장 쉬운 방법은 한 줄의 명령어로 설치하는 것입니다. CLI/파일 도구의 경우 JoinGonka 공급자(baseUrl, 모델)를 자동으로 설정하며, UI 도구의 경우 붙여넣기 위한 값을 보여줍니다.

npx @joingonka/setup --tool roo

설치 프로그램은 범용적이며(플래그 없이 실행 시 목록에서 도구를 선택할 수 있음), jg-…로 시작하는 키를 묻고 설정 후 게이트웨이에 대한 라이브 체크를 수행합니다. 다른 설정은 건드리지 않습니다. 직접 설정하고 싶다면 아래의 수동 방법을 참조하십시오.

수동 설정 (플랜 B)

Roo Code 패널을 열고 설정(톱니바퀴 아이콘)으로 이동합니다. 공급자 섹션에서 다음을 설정하십시오.

  1. API ProviderOpenAI Compatible 선택.
  2. Base URLhttps://gate.joingonka.ai/v1
  3. API Keyjg-귀하의-키
  4. Model (Model ID) — MiniMaxAI/MiniMax-M2.7

하단 Model Configuration 블록에서 모델 파라미터를 수동으로 조정할 수 있습니다.

  • Context Window200000 (200K 토큰).
  • Max Output Tokens8192 (게이트웨이 제한, 모든 네트워크 모델 공통).
  • Input Price / Output Price — 실제 요금(입력 1M당 약 $0.003, 출력은 3배)을 입력하면 Roo Code 인터페이스에서 작업 비용을 정확하게 계산할 수 있습니다.

툴 호출(tool calling) 관련 중요 사항: Roo Code는 *네이티브* 툴 호출만 사용합니다. 이전 에이전트 같은 XML 폴백은 없습니다. 따라서 모델은 function calling 기능을 지원해야 합니다. 당사 게이트웨이를 통한 네트워크 모델은 네이티브 툴 호출을 지원하므로 Roo Code와 바로 연동됩니다.

확인 방법: Roo Code 채팅에 «Hello World를 출력하는 함수가 포함된 hello.py 파일을 만들어줘»라고 입력해 보세요. 에이전트가 파일 생성을 제안하고 승인을 위해 diff를 보여줄 것입니다.

에이전트 세션 비용 비교

Roo Code는 단일 메시지로 답하는 것이 아니라 파일 읽기, 코드 작성, 테스트 실행, 오류 수정 등 작업을 완수하는 에이전트 도구입니다. 각 동작은 모델 호출입니다. 일반적인 세션 비용을 비교해 보겠습니다.

작업토큰 수Anthropic ClaudeOpenAI GPTJoinGonka Gonka
단순 버그 수정~5M$15 — $75$12 — $50$0.024
새로운 기능 (2-3개 파일)~20M$60 — $300$50 — $200$0.096
코드 리팩토링~50M$150 — $750$125 — $500$0.24
전체 개발 세션 (4시간)~100M$300 — $1,500$250 — $1,000$0.48

JoinGonka Gateway를 사용하면 Roo Code를 일상적인 도구로 사용하여 비용 걱정 없이 모든 티켓, 버그, 기능 수정에 활용할 수 있습니다. 시작 시 제공되는 1,000만 개의 무료 토큰으로 수십 개의 작업을 충분히 수행할 수 있습니다.

모델 파라미터 (모든 모델 컨텍스트 200K): 모든 네트워크 모델은 최대 8192 토큰까지 응답 가능합니다. non-stream 요청에 max_tokens가 지정되지 않은 경우, 게이트웨이는 기본적으로 최대 1500 토큰을 반환합니다. 긴 생성 작업은 Roo Code가 자동으로 단계별로 분할합니다.

Roo Code가 Cline과 다른 점: 모드 및 Anthropic 형식

Roo Code는 Cline의 포크 버전이지만, 작업 흐름을 극적으로 바꾸는 몇 가지 차이점이 있습니다:

  • Modes(모드): 작업 목적에 따라 에이전트 역할을 전환하세요. 계획 수립에는 Architect, 코드 작성에는 Code, 프로젝트 질의응답에는 Ask, 디버깅에는 Debug 모드를 사용합니다. 자체 지침과 허용 도구 세트를 설정하여 나만의 모드를 만들 수도 있습니다.
  • 네이티브 tool calling 전용: 텍스트/XML 파싱을 사용하는 에이전트와 달리, Roo Code는 OpenAI의 tools 스키마를 사용하여 도구를 호출하고 이를 별도의 이벤트로 받아 처리하므로 지연 시간이 낮고 결과가 더 안정적입니다. 단, 모델이 function calling을 지원해야 합니다(Gateway를 통한 네트워크 모델은 모두 지원).
  • 커스텀 지침 및 프로필: 프로젝트별 규칙(예: 저장소 내 규칙 파일) 설정 및 여러 프로바이더 구성을 저장하여 필요할 때 간편하게 전환할 수 있습니다.

Anthropic 포맷을 통한 연결. OpenAI 포맷 대신 /v1/messages 엔드포인트를 사용하려면 설정에서 API Provider → Anthropic을 선택하고 「Use custom base URL」을 체크한 뒤 https://gate.joingonka.ai를 입력하세요. Anthropic API Key 필드에 똑같이 jg-당신의-키를 입력하고 모델명(예: MiniMaxAI/MiniMax-M2.7)을 지정합니다. 키와 잔액은 두 포맷 모두 공유되며, Anthropic 모드에서의 네이티브 tool_use 또한 Gateway를 통해 문제없이 처리됩니다.

Roo Code + Gonka = 모드와 네이티브 도구 호출을 갖춘 VS Code용 자율 AI 에이전트가 저렴한 가격에 제공됩니다. 개발 세션은 Anthropic의 $300-1,500 대신 $0.10이며, 10M 무료 토큰은 수십 가지 작업에 충분합니다.

더 자세히 알고 싶으세요?

다른 섹션을 탐색하거나 지금 GNK를 얻기 시작하세요.

1천만 무료 토큰 받기 →