지식 기반 섹션 ▾

내비게이션

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

카테고리

도구 54
용어집 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에서 Extensions (Ctrl+Shift+X)를 열고 "Kilo Code"를 검색하여 Install을 클릭하세요. 설치 후 사이드바에 Kilo Code 아이콘이 나타납니다. 이 확장은 마켓플레이스가 없는 빌드를 위해 Open VSX에서도 사용할 수 있습니다.

JoinGonka API 키: 아직 계정이 없다면 gate.joingonka.ai/register에서 등록하고 3M개의 무료 토큰을 받으세요. Dashboard → API Keys에서 jg- 접두사가 붙은 키를 생성하세요. 동일한 키로 OpenAI 형식(/v1)과 Anthropic 형식(/v1/messages) 모두 사용할 수 있으며 잔액은 공유됩니다.

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

가장 간단한 방법은 한 줄 명령어 설치 프로그램으로 설정하는 것입니다. JoinGonka 프로바이더를 Kilo의 전역 설정(보통 ~/.config/kilo/kilo.jsonc)에 기록합니다: 게이트웨이 주소, 키, 네트워크의 모델과 그 컨텍스트 윈도우 및 응답 상한입니다. 파일은 권한 600이 되고, 아직 직접 모델을 선택하지 않았다면 DeepSeek V4 Flash가 기본 모델이 됩니다:

npx @joingonka/setup --tool kilo

설치 프로그램은 범용이며(플래그가 없으면 목록에서 도구를 선택하라고 요청합니다), jg-… 키를 묻고 설정 후 gateway에 요청을 보내 라이브 검사를 수행합니다. 다른 설정은 건드리지 않습니다. 아래는 직접 설정하고 싶은 분을 위한 수동 방법입니다.

수동으로 설정하기 (플랜 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-your-key
  • Models: deepseek-ai/DeepSeek-V4-Flash-0731을 추가합니다. Kilo는 /v1/models 엔드포인트에서 모델 목록을 자동으로 가져오므로 수동 입력 대신 목록에서 선택할 수 있습니다.

Submit을 누르면 모델이 피커에 나타납니다. 구 인터페이스(VSCode Legacy)에서는 경로가 더 짧습니다: API Provider → OpenAI Compatible, 이어서 Base URL, API Key, Model 필드에 같은 값을 입력합니다.

방법 B — Anthropic 형식. 저희 게이트웨이는 Anthropic API에도 응답합니다. API Provider → Anthropic을 선택하고, 키 jg-your-key를 붙여넣고, 「Use custom base URL」을 체크한 뒤 https://gate.joingonka.ai를 지정합니다(/v1 불필요 — Kilo가 자동으로 /v1/messages를 추가합니다).

모델과 출력 한도 (현재 세 가지 모두 사용 가능):

모델컨텍스트최대 출력
MiniMaxAI/MiniMax-M2.7180K8192
deepseek-ai/DeepSeek-V4-Flash-0731 (설치 프로그램이 설정하는 모델)380K32768
zai-org/GLM-5.3-Flash390K8192

커스텀 프로바이더 대화상자에서 각 모델에 Max Output Tokens와 Context Window를 설정할 수 있습니다 — 선택한 모델에 맞춰 표의 값을 입력하세요.

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

에이전트 세션 비용 비교

Kilo Code는 단순히 답변만 하는 것이 아니라 파일 읽기, 코드 작성, 테스트 실행, 오류 수정 등 작업을 완벽하게 수행하는 에이전트 도구입니다. 각 단계마다 API 호출이 발생하여 토큰이 빠르게 소모됩니다. Anthropic Claude와 Gonka 네트워크 게이트웨이를 통한 세션 비용을 비교해 보세요:

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

JoinGonka Gateway의 입력 비용은 1M 토큰당 ~$0.0062이며 출력 비용은 약 3배입니다. 이는 Anthropic 및 OpenAI보다 수백, 수천 배 저렴한 가격입니다. Kilo Code를 일상적인 도구로 사용하여, 비용 걱정 없이 모든 티켓과 버그, 기능에 대해 상시 실행할 수 있습니다. Anthropic 가격으로는 매 실행마다 비용을 고민해야 합니다.

모델 파라미터: MiniMax M2.7은 180K 컨텍스트 윈도우와 8192 토큰의 최대 응답 길이를 가집니다(DeepSeek V4 Flash는 380K/32768, GLM-5.3 Flash는 390K/8192). Kilo Code가 그 이상의 요청을 하더라도 게이트웨이가 모델의 상한선으로 제한합니다. 긴 생성이 필요할 경우 에이전트가 작업을 단계별로 분할합니다.

모드 및 툴 콜링

Kilo Code의 강점은 드롭다운, /agents 명령어, 또는 Ctrl+. 단축키로 전환 가능한 모드(구 익스텐션의 modes, 신규 버전의 agents)에 있습니다:

  • Plan / Architect — 파일을 직접 수정하지 않고 토론 및 솔루션 설계. GLM-5.3 Flash 사용을 권장합니다. 추론 모델이 답변 전 사고를 하며, 기획 단계에서 많은 컨텍스트를 소모하지만 당사 게이트웨이에서는 매우 저렴합니다.
  • Code — 기본 모드: 코드 작성, 수정, diff 적용, 명령어 실행.
  • Debug — 로그와 스택 추적을 기반으로 버그 원인을 정확히 타겟팅.
  • Ask — 코드 변경 없이 베이스에 대한 질의응답.

최신 버전에서 Orchestrator 모드는 더 이상 사용되지 않습니다. 도구에 대한 완전한 접근 권한을 가진 에이전트는 별도의 오케스트레이터 없이도 서브태스크(subagents)를 스스로 실행할 수 있습니다. 사용자 정의 모드 또한 지원합니다.

Tool calling: 당사 게이트웨이는 네이티브 OpenAI function calling과 Anthropic tool_use를 전달하며, 선택된 모델(MiniMax M2.7, DeepSeek V4 Flash, GLM-5.3 Flash) 모두 툴 호출을 지원합니다. 즉, Kilo Code의 에이전트 루프(파일 읽기, 수정, 명령어 실행, 코드 인덱싱)가 취약한 텍스트 파싱 과정 없이 당사 모델 위에서 안정적으로 작동합니다.

Kilo Code + Gonka = Plan/Code/Debug 모드를 갖춘 VS Code용 오픈 AI 에이전트를 저렴하게 이용. 개발 세션 비용은 Anthropic의 $300~$1500 대신 약 $0.10이며, 시작 토큰으로 카드 없이 체험 가능합니다.

더 자세히 알고 싶으세요?

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

무료 토큰 받기 →