지식 기반 섹션 ▾

내비게이션

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

카테고리

도구 32
용어집 12

도구

Kilo Code + Gonka AI — VS Code용 AI 에이전트

Kilo Code는 VS Code용 오픈 AI 에이전트 확장 프로그램으로, 코드를 자율적으로 작성하고 편집하며, 터미널에서 명령을 실행하고, 수십 개의 파일을 한 번에 읽고 수정합니다. 이 프로젝트는 Cline과 Roo Code의 강점을 결합하여 통합 에이전트 플랫폼으로 발전하고 있습니다. IDE 확장 외에도 JetBrains 및 CLI용 변형도 있습니다. 주요 특징은 모드 (에이전트)입니다. Code (코드 작성), Plan (Architect와 동일 — 수정 없이 아키텍처 계획), Debug (오류 원인 검색) 및 Ask (프로젝트에 대한 질문에 답변). 또한 자신만의 모드를 만들 수도 있습니다.

문제는 다른 모든 에이전트와 동일합니다. 토큰 소비입니다. Kilo Code는 파일 컨텍스트, 명령 출력, 단계 기록을 모델로 전송합니다. 한 가지 작업에 10-100M 토큰이 쉽게 소모됩니다. Anthropic 가격 (1M당 $3-15)으로는 세션당 $30-1500가 발생하여 일상적인 작업에는 비실용적입니다.

JoinGonka Gateway는 비용을 수백, 수천 배 절감합니다. 동일한 세션에 $0.01-1.00가 소요됩니다. Kilo Code는 오픈 소스이며 모든 OpenAI 호환 엔드포인트 (및 사용자 지정 기본 URL을 가진 Anthropic 형식)를 지원하므로 게이트웨이를 연결하는 것은 설정 한 번이면 됩니다. 이는 Kilo Code를 비싼 시연에서 일상적인 도구로 변화시킵니다.

단계 1: Kilo Code 설치 및 키 얻기

Kilo Code 설치: VS Code에서 확장 (Ctrl+Shift+X)을 열고, "Kilo Code"를 찾아 설치를 클릭합니다. 설치 후 사이드바에 Kilo Code 아이콘이 나타납니다. 확장 프로그램은 Marketplace가 없는 빌드의 Open VSX에서도 사용할 수 있습니다.

JoinGonka API 키: 아직 계정이 없다면 gate.joingonka.ai/register에 등록하여 10M 무료 토큰을 받고 Dashboard → API Keys에서 jg- 접두사가 붙은 키를 생성하세요. 동일한 키가 OpenAI 형식 (/v1)과 Anthropic 형식 (/v1/messages) 모두 작동하며, 잔액은 통합됩니다.

단계 2: Kilo Code 설정 (OpenAI Compatible)

가장 쉬운 방법은 원커맨드 설치 프로그램을 사용하는 것입니다. CLI/파일 도구의 경우 프로바이더(JoinGonka, baseUrl, 모델)를 자동으로 설정하며, UI 도구의 경우 붙여넣기용 값을 표시합니다:

npx @joingonka/setup --tool kilo

설치 프로그램은 범용입니다(플래그를 입력하지 않으면 목록에서 도구를 선택하라는 메시지가 뜹니다). jg-… 키를 입력하면 설정 후 게이트웨이로 라이브 체크 요청을 보냅니다. 다른 설정은 건드리지 않습니다. 직접 설정하려면 아래의 수동 설정 방식을 따르세요.

수동 설정(플랜 B)

Kilo Code 패널을 열고 톱니바퀴 아이콘을 통해 프로바이더 설정으로 들어갑니다.

방법 A — OpenAI Compatible (권장). 확장 프로그램의 최신 버전에서 Settings(톱니바퀴) → Providers 탭 → 하단의 Custom provider 버튼을 클릭하고 다음과 같이 입력합니다:

  • Provider ID: 임의의 식별자(예: joingonka).
  • Display name: 예: JoinGonka Gonka.
  • Base URL: https://gate.joingonka.ai/v1
  • API key: jg-본인의키
  • Models: MiniMaxAI/MiniMax-M2.7을 추가합니다. Kilo은 /v1/models 엔드포인트에서 모델 목록을 자동으로 불러오므로 직접 입력하지 않고 선택할 수 있습니다.

Submit을 누르면 모델 선택기에 모델이 나타납니다. 이전 인터페이스(VSCode Legacy)에서는 API ProviderOpenAI Compatible을 선택하고, Base URL, API Key, Model 필드에 똑같이 입력합니다.

방법 B — Anthropic 형식. 저희 게이트웨이는 Anthropic API에도 응답합니다. API ProviderAnthropic을 선택하고, 키 jg-본인의키를 입력한 뒤 「Use custom base URL」을 체크하고 https://gate.joingonka.ai를 지정합니다(/v1은 입력하지 마세요. Kilo이 자동으로 /v1/messages를 추가합니다).

모델 및 출력 제한(두 모델 모두 즉시 사용 가능):

모델컨텍스트최대 출력
moonshotai/Kimi-K2.6 (기본값)200K8192
MiniMaxAI/MiniMax-M2.7200K8192

커스텀 프로바이더 다이얼로그의 각 모델 항목에서 Max Output TokensContext Window를 설정할 수 있습니다. 위 표의 값을 모델에 맞춰 설정하세요.

확인: Kilo Code 채팅에서 Code 모드를 선택하고 'hello world 함수가 있는 hello.py 파일을 생성해줘'라고 작성하세요. 에이전트가 diff를 제안하고 승인 시 파일을 생성해야 합니다. 기본적으로 Kilo Code는 각 작업 전에 확인을 요청하지만, 신뢰할 수 있는 작업에 대해서는 자동 실행을 허용하여 이를 완화할 수 있습니다.

에이전트 세션 비용 비교

Kilo Code는 대답만 하는 것이 아니라 파일 읽기, 코드 작성, 테스트 실행, 오류 수정 등 작업을 전체적으로 수행하는 에이전트 도구입니다. 각 단계는 API 호출이며 토큰이 빠르게 누적됩니다. Anthropic Claude와 당사의 Gonka 네트워크 Gateway를 통한 일반적인 세션 비용을 비교해 보겠습니다.

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

JoinGonka Gateway를 통하면 입력 비용은 1M 토큰당 약 $0.003이며, 출력은 그보다 3배 정도 비싸지만 Anthropic이나 OpenAI보다 수백에서 수천 배 저렴합니다. Kilo Code는 일상적인 도구가 되어 비용 부담 없이 모든 티켓, 버그, 기능 수정에 사용할 수 있습니다. Anthropic 가격으로는 매번 실행을 고민해야 할 것입니다.

모델 파라미터: 네트워크 모델의 컨텍스트 윈도우는 200K 토큰이며 최대 응답 길이는 8192 토큰입니다. Kilo Code가 그 이상을 요청할 수 있지만, 게이트웨이가 모델의 상한선(모든 네트워크 모델에 대해 8192)으로 제한합니다. 긴 생성이 필요한 경우 에이전트가 작업을 단계별로 분할합니다.

모드 및 툴 콜링

Kilo Code의 핵심 강점은 모드(이전 버전은 modes, 새 버전은 agents) 전환 기능입니다. 드롭다운이나 /agents 명령어, 또는 Ctrl+. 단축키로 전환할 수 있습니다:

  • Plan / Architect — 파일을 수정하지 않고 솔루션을 설계합니다. 계획 수립 시 컨텍스트를 많이 소비하지만, 저희 게이트웨이에서는 매우 저렴합니다.
  • Code — 기본 모드: 코드 작성, 수정, diff 적용 및 명령어 실행을 담당합니다.
  • Debug — 로그와 스택을 기반으로 버그 원인을 정확히 추적합니다.
  • Ask — 변경 없이 코드베이스에 대해 질의응답합니다.

최신 버전에서는 별도의 Orchestrator 모드가 폐기되었습니다. 도구에 대한 전체 권한을 가진 에이전트가 스스로 하위 작업(subagents)을 실행할 수 있게 되었기 때문입니다. 사용자의 환경에 맞춘 커스텀 모드도 지원합니다.

Tool calling: 저희 게이트웨이는 OpenAI 함수 호출 및 Anthropic tool_use를 그대로 전달하며, 선택된 모델(Kimi K2.6, MiniMax-M2.7) 모두 도구 호출을 지원합니다. 즉, 파일 읽기부터 수정, 명령어 실행, 코드베이스 인덱싱으로 이어지는 Kilo Code의 에이전트 루프가 텍스트 파싱 오류 없이 저희 모델 위에서 안정적으로 작동합니다.

Kilo Code + Gonka = Plan/Code/Debug 모드를 갖춘 VS Code용 오픈 AI 에이전트를 저렴하게 이용하세요. 개발 세션은 Anthropic의 $300-1500 대신 약 $0.10이며, 10M 무료 토큰으로 수십 개의 작업을 수행할 수 있습니다.

더 자세히 알고 싶으세요?

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

1천만 무료 토큰 받기 →