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

중요: Roo Code 확장은 2026년 5월 15일에 종료되었습니다. 저장소는 아카이브로 전환되었으며 더 이상의 업데이트는 없습니다. 개발은 Roo Code 커뮤니티가 시작한 포크인 Zoo Code에서 계속 진행됩니다. 제공자 설정은 동일하며, 이전을 위한 마이그레이션 가이드와 Zoo Code 가이드를 참고하세요. 그 외 VS Code용 오픈 소스 에이전트로는 Kilo Code와 Roo Code의 원형인 Cline이 있습니다. 이미 설치된 확장은 계속 작동하며 아래의 지침은 여전히 유효합니다.

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

이러한 에이전트의 주요 문제는 토큰 소비량입니다. Roo Code는 하나의 작업에 대해 파일 컨텍스트, 명령 출력, 도구 결과 등을 처리하므로 수천만 토큰이 소모됩니다. Anthropic의 가격(1M 토큰당 $3-15)으로는 한 번의 완전한 세션이 $30-1500에 달합니다. 일상 업무에 사용하기에는 비현실적입니다.

JoinGonka Gateway는 비용을 수천 배 절감하여 동일한 세션을 $0.01-1.00에 실행할 수 있게 합니다. Gateway는 Gonka 분산 네트워크의 추론(inference)을 재판매하며, OpenAI 포맷(OpenAI Compatible 제공자)과 Anthropic 포맷(엔드포인트 /v1/messages)을 모두 지원하므로 Roo Code는 둘 중 하나를 통해 연결할 수 있습니다. 이를 통해 Roo Code는 값비싼 데모 도구에서 실용적인 일상 업무 도구로 변모합니다.

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

Roo Code 설치: VS Code에서 Extensions(Ctrl/Cmd+Shift+X)를 열고 "Roo Code"를 검색하여 설치를 누르세요. 설치 후 사이드바에 Roo Code 캥거루 아이콘이 나타납니다. 확장 프로그램은 마켓플레이스에 그대로 있지만, 2026년 5월 15일에 출시된 3.54.0 버전이 마지막 업데이트입니다.

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

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

가장 간단한 방법은 한 줄 명령어 설치 프로그램을 사용하는 것입니다. CLI/파일 도구의 경우 JoinGonka 프로바이더(baseUrl, 모델)를 자동으로 설정해 주고, UI 도구의 경우 붙여넣을 수 있는 값을 보여줍니다:

npx @joingonka/setup --tool roo

이 명령은 먼저 Roo Code를 종료하고 어디로 이동해야 하는지(--tool zoo, --tool cline, --tool kilo)를 알려준 다음, 해당 확장 프로그램이 아직 설치된 사용자를 위한 값과 함께 모델의 실제 컨텍스트 윈도우와 응답 상한을 출력합니다. 설치 프로그램은 jg-… 키를 묻고 gateway에 요청을 보내는 라이브 검증으로 마무리합니다. 아래는 직접 설정하는 것을 선호하는 경우를 위한 수동 방법입니다.

수동으로 설정하기(플랜 B)

Roo Code 패널을 열고 설정(톱니바퀴 아이콘)으로 이동합니다. 프로바이더 섹션에서 다음을 지정하세요:

API Provider — OpenAI Compatible을 선택합니다.
Base URL — https://gate.joingonka.ai/v1
API Key — jg-your-key
Model (Model ID) — MiniMaxAI/MiniMax-M2.7

아래 Model Configuration 블록에서 모델 파라미터를 수동으로 세부 조정할 수 있습니다:

Context Window — 180000(180K 토큰, DeepSeek V4 Flash는 380000).
Max Output Tokens — MiniMax M2.7 및 GLM-5.3 Flash의 경우 8192, DeepSeek V4 Flash의 경우 32768.
Input Price / Output Price — 실제 요율(입력 1M당 ≈$0.0062, 출력 ×3)을 입력하면 Roo Code가 인터페이스에서 작업 비용을 정확하게 계산할 수 있습니다.

tool calling에 관한 중요 사항: Roo Code는 오직 네이티브 tool calling만 사용합니다. 구형 에이전트에 있던 XML 폴백은 여기에 없습니다. 따라서 모델은 반드시 function calling을 지원해야 합니다. 네트워크의 모델들은 우리 Gateway를 통해 네이티브 tool calling을 지원하므로 Roo Code에서 바로 작동합니다.

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

에이전트 세션 비용 비교

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

작업	토큰	Anthropic Claude	OpenAI GPT	JoinGonka Gonka
단순 버그 수정	~5M	$15 — $75	$12 — $50	$0.048
신규 기능 (2-3 파일)	~20M	$60 — $300	$50 — $200	$0.19
모듈 리팩토링	~50M	$150 — $750	$125 — $500	$0.48
전체 개발 세션 (4시간)	~100M	$300 — $1,500	$250 — $1,000	$0.96

JoinGonka Gateway를 사용하면 Roo Code를 일상적인 도구로 활용할 수 있습니다. 비용 걱정 없이 티켓, 버그, 기능 요청마다 사용할 수 있습니다. 3M 무료 토큰이 기본 제공되므로 신용카드 없이도 조합을 테스트해 볼 수 있습니다.

모델 파라미터: MiniMax M2.7은 180K 윈도우에 최대 8192 토큰 응답, DeepSeek V4 Flash는 380K에 최대 32768, GLM-5.3 Flash는 390K에 최대 8192를 지원합니다. non-stream 요청에서 max_tokens가 지정되지 않은 경우, Gateway는 기본적으로 최대 1500 토큰(GLM-5.3 Flash는 최대 3000)을 반환합니다. 긴 생성 작업은 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-your-key를 붙여넣은 다음 모델 이름(예: MiniMaxAI/MiniMax-M2.7)을 지정하세요. 키와 잔액은 두 형식에서 공통이며, Anthropic 모드의 네이티브 tool_use도 Gateway를 통과합니다.

Roo Code + Gonka = VS Code 내에서 네이티브 tool calling을 지원하는 저렴하고 강력한 자율형 AI 에이전트. 개발 세션당 비용이 Anthropic의 $300-1,500 대비 $0.10에 불과하며, 시작 토큰으로 카드 없이 체험 가능합니다. 해당 확장 기능은 2026년 5월 15일에 종료되었으므로, 신규 설치 시 커뮤니티 포크인 Zoo Code나 Kilo Code 또는 Cline을 사용하세요.

← LibreChat + Gonka AI — 오픈소스 ChatGPT LlamaIndex + Gonka AI — 저렴한 RAG 애플리케이션 →

더 자세히 알고 싶으세요?

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

무료 토큰 받기 →