Kilo Code: 오픈 소스 AI 코딩 도구 (2026)

Kilo Code: 오픈 소스 AI 코딩 툴 (2026)

Kilo Code는 VS Code 확장 프로그램으로 실행되는 오픈 소스 AI 코딩 어시스턴트입니다. 이는 Cline(원래 명칭 Claude Dev)의 포크 버전으로, 개선된 UX, 낮은 토큰 사용량, 그리고 다양한 AI 제공자(Provider)에 대한 더 나은 지원에 중점을 두고 있습니다. VS Code 내부에서 작동하면서 Cursor의 AI 기능에 대한 무료 오픈 소스 대안을 찾고 있었다면, Kilo Code는 검토해 볼 만한 가치가 있습니다.

Kilo Code란 무엇인가요?

Kilo Code는 에디터 내에서 AI 코딩 에이전트를 직접 제공하는 VS Code 확장 프로그램입니다. 다음과 같은 작업이 가능합니다:

프로젝트 내 파일 읽기 및 쓰기
터미널 명령 실행
문서 검색을 위한 웹 브라우징
단일 태스크에서 여러 파일 생성 및 편집
API를 통한 모든 AI 모델 사용 (Claude, GPT, Gemini, 로컬 모델)
실행 전 정확히 무엇을 할 계획인지 사용자에게 표시

Kilo Code는 단순한 코드 완성 도구(예: Copilot)와는 다릅니다. 이는 **에이전트(Agent)**이기 때문입니다. 즉, "테스트와 문서가 포함된 새로운 REST API 엔드포인트 생성"과 같은 다단계 작업을 자율적으로 수행할 수 있습니다.

Kilo Code vs Cline vs Cursor

기능	Kilo Code	Cline	Cursor
오픈 소스	예 (Apache 2.0)	예 (Apache 2.0)	아니요
VS Code 구동	예	예	별도 에디터 (VS Code 포크)
모델 지원	모든 API (Claude, GPT, Gemini, Ollama)	모든 API	Claude, GPT (내장)
파일 편집	예 (승인 후)	예 (승인 후)	예 (인라인 + 채팅)
터미널 액세스	예	예	예
웹 브라우징	예	예	아니요
토큰 최적화	Cline보다 개선됨	기본 수준	독점 기술(Proprietary)
가격	무료 (본인 API 키 사용)	무료 (본인 API 키 사용)	월 $20 + API 비용
커스텀 모드	예	제한적임	아니요

설치 방법

VS Code Marketplace에서 설치

1. VS Code를 엽니다.
2. 확장(Extensions) 탭으로 이동합니다 (Ctrl+Shift+X / Cmd+Shift+X).
3. "Kilo Code"를 검색합니다.
4. 설치(Install)를 클릭합니다.
5. 필요한 경우 VS Code를 다시 로드합니다.

커맨드 라인에서 설치

code --install-extension kilocode.kilo-code

소스에서 설치 (기여자용)

git clone https://github.com/kilocode/kilo-code.git
cd kilo-code
npm install
npm run build

# 확장 프로그램 패키징
npx vsce package

# .vsix 파일 설치
code --install-extension kilo-code-*.vsix

설정

설치 후 AI 제공자(Provider)를 설정해야 합니다.

Step 1: Kilo Code 설정 열기

Ctrl+Shift+P (macOS는 Cmd+Shift+P)를 누르고 "Kilo Code: Open Settings"를 입력합니다.

Step 2: AI 제공자 설정

Kilo Code는 여러 제공자를 지원합니다. 가장 일반적인 설정은 다음과 같습니다:

Anthropic (Claude):

{
  "kilocode.provider": "anthropic",
  "kilocode.apiKey": "sk-ant-xxxxx",
  "kilocode.model": "claude-sonnet-4-20250514"
}

OpenAI (GPT):

{
  "kilocode.provider": "openai",
  "kilocode.apiKey": "sk-xxxxx",
  "kilocode.model": "gpt-4o"
}

Google (Gemini):

{
  "kilocode.provider": "google",
  "kilocode.apiKey": "AIzaSyxxxxx",
  "kilocode.model": "gemini-2.0-flash"
}

로컬 모델 (Ollama):

{
  "kilocode.provider": "ollama",
  "kilocode.baseUrl": "http://localhost:11434",
  "kilocode.model": "qwen2.5-coder:32b"
}

OpenRouter (모든 모델 액세스):

{
  "kilocode.provider": "openrouter",
  "kilocode.apiKey": "sk-or-xxxxx",
  "kilocode.model": "anthropic/claude-sonnet-4-20250514"
}

Kilo Code 사용하기

기본 사용법

액티비티 바(왼쪽 사이드바의 Kilo 아이콘)에서 Kilo Code 패널을 열거나 단축키를 누릅니다. 그 다음 자연어로 요청을 입력하세요:

현재 타임스탬프와 업타임을 반환하는 /health 엔드포인트가 포함된
Node.js Express 서버를 만들어줘.

Kilo Code는 다음과 같이 동작합니다:

파일 변경 계획을 수립합니다.
생성하거나 수정할 내용을 정확히 보여줍니다.
사용자의 승인을 기다립니다.
변경 사항을 실행합니다.
선택적으로 명령(예: npm install express)을 실행합니다.

다중 파일 작업

Kilo Code는 여러 파일에 걸친 작업에 뛰어난 성능을 보입니다:

이 Express 앱에 사용자 인증 기능을 추가해줘:
- 이메일과 해싱된 비밀번호를 가진 User 모델 생성
- /register 및 /login 엔드포인트 추가
- 보호된 경로를 위한 JWT 미들웨어 생성
- 인증 엔드포인트에 대한 테스트 추가

터미널 명령

Kilo Code는 사용자의 승인을 받아 터미널 명령을 실행할 수 있습니다:

필요한 의존성을 설치하고 테스트 코드를 실행해줘.

실행 전, 정확한 명령어를 다음과 같이 보여줍니다:

# Kilo Code 제안:
npm install bcryptjs jsonwebtoken
npm test

각 명령을 승인, 수정 또는 거부할 수 있습니다.

웹 브라우징

Kilo Code는 작업을 위해 웹에서 최신 문서를 가져올 수 있습니다:

최신 Prisma ORM 마이그레이션 구문을 찾아보고,
"users" 및 "posts" 테이블에 대한 외래 키를 가진
"comments" 테이블을 추가하는 마이그레이션을 생성해줘.

커스텀 모드 (Custom Modes)

Kilo Code의 핵심 기능 중 하나는 커스텀 모드입니다. 모드를 통해 다양한 작업 유형에 맞게 AI의 동작 방식을 설정할 수 있습니다.

내장 모드

모드	설명	도구 접근 권한
Code	기본 코딩 모드	파일, 터미널, 브라우저 전체 접근
Architect	설계 모드	파일 읽기 전용, 터미널 불가
Ask	Q&A 모드	읽기 전용, 정보성 응답
Debug	디버깅 모드	진단 중심의 전체 접근

커스텀 모드 생성하기

프로젝트 루트에 .kilo/modes.json 파일을 생성합니다:

{
  "modes": [
    {
      "slug": "reviewer",
      "name": "Code Reviewer",
      "roleDefinition": "당신은 시니어 코드 리뷰어입니다. 버그, 보안 문제, 베스트 프랙티스를 분석하세요. 파일을 직접 수정하지 마세요.",
      "groups": ["read"],
      "customInstructions": "오류 처리, 입력 유효성 검사, SQL 인젝션, XSS, 레이스 컨디션에 집중하세요. 라인 번호를 구체적으로 언급하세요."
    },
    {
      "slug": "docs",
      "name": "Documentation Writer",
      "roleDefinition": "당신은 테크니컬 라이터입니다. 명확하고 간결한 문서를 작성하세요.",
      "groups": ["read", "edit"],
      "customInstructions": "함수에 대한 JSDoc 주석, README 섹션, 복잡한 로직에 대한 인라인 주석을 작성하세요."
    }
  ]
}

Kilo Code 패널의 드롭다운을 사용하거나 /mode reviewer를 입력하여 모드를 전환할 수 있습니다.

토큰 사용량 최적화

Kilo Code는 토큰 소비를 줄이기 위한 여러 기능을 포함하고 있습니다:

컨텍스트 관리

# Kilo Code 자동 수행 사항:
- 프로젝트 전체가 아닌 관련 파일만 AI에게 전송
- 대용량 파일은 관련 섹션만 잘라서 전송
- 대화 내에서 파일 읽기 결과 캐싱
- 출력 토큰 최소화를 위해 diff 기반 편집 사용

수동 컨텍스트 제어

전송되는 컨텍스트를 명시적으로 제어할 수 있습니다:

@file:src/auth/middleware.ts @file:src/models/user.ts
인증 미들웨어의 JWT 검증을 수정해줘 - 토큰 만료를 올바르게 확인해야 해.

@file: 접두사는 특정 파일을 컨텍스트에 포함하도록 Kilo Code에 지시합니다.

비용 추적

Kilo Code는 패널에 실시간 토큰 사용량과 예상 비용을 표시합니다:

Task: 사용자 인증 추가
사용된 토큰: 입력 12,450 / 출력 3,200
예상 비용: $0.08 (Claude Sonnet 4)

설정 파일 레퍼런스

VS Code settings.json의 글로벌 설정:

{
  "kilocode.provider": "anthropic",
  "kilocode.model": "claude-sonnet-4-20250514",
  "kilocode.apiKey": "sk-ant-xxxxx",
  "kilocode.maxTokens": 8192,
  "kilocode.temperature": 0,
  "kilocode.autoApprove": {
    "readFiles": true,
    "listFiles": true,
    "writeFiles": false,
    "executeCommands": false
  },
  "kilocode.customInstructions": "항상 TypeScript를 사용하세요. React에서는 함수형 컴포넌트를 선호합니다. 스타일링에는 Tailwind CSS를 사용하세요."
}

프로젝트별 지침

프로젝트별 지침을 위해 프로젝트 루트에 .kilo/instructions.md 파일을 생성하세요:

# 프로젝트 지침

- 이 프로젝트는 App Router를 사용하는 Next.js 15 앱입니다.
- 데이터베이스 액세스에는 Prisma를 사용합니다.
- 모든 API 경로는 Zod로 입력을 검증해야 합니다.
- 테스트는 Vitest를 사용합니다.
- npm이나 yarn이 아닌 pnpm을 사용하세요.

트러블슈팅

문제 상황	원인	해결 방법
"API key invalid"	잘못된 키 또는 만료됨	제공자 대시보드에서 키 재발급
확장 프로그램 로드 실패	VS Code 버전이 너무 낮음	VS Code를 최신 버전으로 업데이트
응답 속도 느림	큰 컨텍스트 또는 모델 속도	더 빠른 모델 사용, `@file:`로 컨텍스트 축소
파일 편집 미적용	권한 문제	VS Code 작업 영역 삭제(Trust) 설정 확인
터미널 명령 실패	쉘 감지 불가	설정에서 `kilocode.shell` 지정
과도한 토큰 사용	너무 많은 컨텍스트 전송	`@file:`로 제한, 불필요한 파일 닫기

결론

Kilo Code는 구독 서비스나 별도의 에디터 없이도 VS Code에 자율형 AI 코딩 에이전트 기능을 제공합니다. 다양한 AI 제공자 지원, 커스텀 모드, 그리고 토큰 최적화 기능은 유료 도구들에 대항하는 강력한 오픈 소스 대안이 됩니다. 가장 큰 장점은 유연성입니다. 사용자가 직접 AI 제공자를 선택하고, 비용을 제어하며, 워크플로우에 맞춰 에이전트의 동작을 커스터마이징할 수 있습니다.

비디오 제작, 아바타 생성, 이미지 처리 등 AI 생성 미디어를 포함하는 애플리케이션을 구축하기 위해 Kilo Code를 사용하는 개발자라면, Hypereal AI를 통해 GPU 인프라 관리 없이도 이러한 기능들을 프로젝트에 간단하고 저렴하게 통합할 수 있는 API를 활용해 보세요.

Kilo Code: 오픈 소스 AI 코딩 툴 (2026)

Kilo Code란 무엇인가요?

Kilo Code는 에디터 내에서 AI 코딩 에이전트를 직접 제공하는 VS Code 확장 프로그램입니다. 다음과 같은 작업이 가능합니다:

프로젝트 내 파일 읽기 및 쓰기
터미널 명령 실행
문서 검색을 위한 웹 브라우징
단일 태스크에서 여러 파일 생성 및 편집
API를 통한 모든 AI 모델 사용 (Claude, GPT, Gemini, 로컬 모델)
실행 전 정확히 무엇을 할 계획인지 사용자에게 표시

Kilo Code vs Cline vs Cursor

기능	Kilo Code	Cline	Cursor
오픈 소스	예 (Apache 2.0)	예 (Apache 2.0)	아니요
VS Code 구동	예	예	별도 에디터 (VS Code 포크)
모델 지원	모든 API (Claude, GPT, Gemini, Ollama)	모든 API	Claude, GPT (내장)
파일 편집	예 (승인 후)	예 (승인 후)	예 (인라인 + 채팅)
터미널 액세스	예	예	예
웹 브라우징	예	예	아니요
토큰 최적화	Cline보다 개선됨	기본 수준	독점 기술(Proprietary)
가격	무료 (본인 API 키 사용)	무료 (본인 API 키 사용)	월 $20 + API 비용
커스텀 모드	예	제한적임	아니요

설치 방법

VS Code Marketplace에서 설치

1. VS Code를 엽니다.
2. 확장(Extensions) 탭으로 이동합니다 (Ctrl+Shift+X / Cmd+Shift+X).
3. "Kilo Code"를 검색합니다.
4. 설치(Install)를 클릭합니다.
5. 필요한 경우 VS Code를 다시 로드합니다.

커맨드 라인에서 설치

code --install-extension kilocode.kilo-code

소스에서 설치 (기여자용)

git clone https://github.com/kilocode/kilo-code.git
cd kilo-code
npm install
npm run build

# 확장 프로그램 패키징
npx vsce package

# .vsix 파일 설치
code --install-extension kilo-code-*.vsix

설정

설치 후 AI 제공자(Provider)를 설정해야 합니다.

Step 1: Kilo Code 설정 열기

Ctrl+Shift+P (macOS는 Cmd+Shift+P)를 누르고 "Kilo Code: Open Settings"를 입력합니다.

Step 2: AI 제공자 설정

Kilo Code는 여러 제공자를 지원합니다. 가장 일반적인 설정은 다음과 같습니다:

Anthropic (Claude):

{
  "kilocode.provider": "anthropic",
  "kilocode.apiKey": "sk-ant-xxxxx",
  "kilocode.model": "claude-sonnet-4-20250514"
}

OpenAI (GPT):

{
  "kilocode.provider": "openai",
  "kilocode.apiKey": "sk-xxxxx",
  "kilocode.model": "gpt-4o"
}

Google (Gemini):

{
  "kilocode.provider": "google",
  "kilocode.apiKey": "AIzaSyxxxxx",
  "kilocode.model": "gemini-2.0-flash"
}

로컬 모델 (Ollama):

{
  "kilocode.provider": "ollama",
  "kilocode.baseUrl": "http://localhost:11434",
  "kilocode.model": "qwen2.5-coder:32b"
}

OpenRouter (모든 모델 액세스):

{
  "kilocode.provider": "openrouter",
  "kilocode.apiKey": "sk-or-xxxxx",
  "kilocode.model": "anthropic/claude-sonnet-4-20250514"
}

Kilo Code 사용하기

기본 사용법

액티비티 바(왼쪽 사이드바의 Kilo 아이콘)에서 Kilo Code 패널을 열거나 단축키를 누릅니다. 그 다음 자연어로 요청을 입력하세요:

현재 타임스탬프와 업타임을 반환하는 /health 엔드포인트가 포함된
Node.js Express 서버를 만들어줘.

Kilo Code는 다음과 같이 동작합니다:

파일 변경 계획을 수립합니다.
생성하거나 수정할 내용을 정확히 보여줍니다.
사용자의 승인을 기다립니다.
변경 사항을 실행합니다.
선택적으로 명령(예: npm install express)을 실행합니다.

다중 파일 작업

Kilo Code는 여러 파일에 걸친 작업에 뛰어난 성능을 보입니다:

이 Express 앱에 사용자 인증 기능을 추가해줘:
- 이메일과 해싱된 비밀번호를 가진 User 모델 생성
- /register 및 /login 엔드포인트 추가
- 보호된 경로를 위한 JWT 미들웨어 생성
- 인증 엔드포인트에 대한 테스트 추가

터미널 명령

Kilo Code는 사용자의 승인을 받아 터미널 명령을 실행할 수 있습니다:

필요한 의존성을 설치하고 테스트 코드를 실행해줘.

실행 전, 정확한 명령어를 다음과 같이 보여줍니다:

# Kilo Code 제안:
npm install bcryptjs jsonwebtoken
npm test

각 명령을 승인, 수정 또는 거부할 수 있습니다.

웹 브라우징

Kilo Code는 작업을 위해 웹에서 최신 문서를 가져올 수 있습니다:

최신 Prisma ORM 마이그레이션 구문을 찾아보고,
"users" 및 "posts" 테이블에 대한 외래 키를 가진
"comments" 테이블을 추가하는 마이그레이션을 생성해줘.

커스텀 모드 (Custom Modes)

Kilo Code의 핵심 기능 중 하나는 커스텀 모드입니다. 모드를 통해 다양한 작업 유형에 맞게 AI의 동작 방식을 설정할 수 있습니다.

내장 모드

모드	설명	도구 접근 권한
Code	기본 코딩 모드	파일, 터미널, 브라우저 전체 접근
Architect	설계 모드	파일 읽기 전용, 터미널 불가
Ask	Q&A 모드	읽기 전용, 정보성 응답
Debug	디버깅 모드	진단 중심의 전체 접근

커스텀 모드 생성하기

프로젝트 루트에 .kilo/modes.json 파일을 생성합니다:

{
  "modes": [
    {
      "slug": "reviewer",
      "name": "Code Reviewer",
      "roleDefinition": "당신은 시니어 코드 리뷰어입니다. 버그, 보안 문제, 베스트 프랙티스를 분석하세요. 파일을 직접 수정하지 마세요.",
      "groups": ["read"],
      "customInstructions": "오류 처리, 입력 유효성 검사, SQL 인젝션, XSS, 레이스 컨디션에 집중하세요. 라인 번호를 구체적으로 언급하세요."
    },
    {
      "slug": "docs",
      "name": "Documentation Writer",
      "roleDefinition": "당신은 테크니컬 라이터입니다. 명확하고 간결한 문서를 작성하세요.",
      "groups": ["read", "edit"],
      "customInstructions": "함수에 대한 JSDoc 주석, README 섹션, 복잡한 로직에 대한 인라인 주석을 작성하세요."
    }
  ]
}

Kilo Code 패널의 드롭다운을 사용하거나 /mode reviewer를 입력하여 모드를 전환할 수 있습니다.

토큰 사용량 최적화

Kilo Code는 토큰 소비를 줄이기 위한 여러 기능을 포함하고 있습니다:

컨텍스트 관리

# Kilo Code 자동 수행 사항:
- 프로젝트 전체가 아닌 관련 파일만 AI에게 전송
- 대용량 파일은 관련 섹션만 잘라서 전송
- 대화 내에서 파일 읽기 결과 캐싱
- 출력 토큰 최소화를 위해 diff 기반 편집 사용

수동 컨텍스트 제어

전송되는 컨텍스트를 명시적으로 제어할 수 있습니다:

@file:src/auth/middleware.ts @file:src/models/user.ts
인증 미들웨어의 JWT 검증을 수정해줘 - 토큰 만료를 올바르게 확인해야 해.

@file: 접두사는 특정 파일을 컨텍스트에 포함하도록 Kilo Code에 지시합니다.

비용 추적

Kilo Code는 패널에 실시간 토큰 사용량과 예상 비용을 표시합니다:

Task: 사용자 인증 추가
사용된 토큰: 입력 12,450 / 출력 3,200
예상 비용: $0.08 (Claude Sonnet 4)

설정 파일 레퍼런스

VS Code settings.json의 글로벌 설정:

{
  "kilocode.provider": "anthropic",
  "kilocode.model": "claude-sonnet-4-20250514",
  "kilocode.apiKey": "sk-ant-xxxxx",
  "kilocode.maxTokens": 8192,
  "kilocode.temperature": 0,
  "kilocode.autoApprove": {
    "readFiles": true,
    "listFiles": true,
    "writeFiles": false,
    "executeCommands": false
  },
  "kilocode.customInstructions": "항상 TypeScript를 사용하세요. React에서는 함수형 컴포넌트를 선호합니다. 스타일링에는 Tailwind CSS를 사용하세요."
}

프로젝트별 지침

프로젝트별 지침을 위해 프로젝트 루트에 .kilo/instructions.md 파일을 생성하세요:

# 프로젝트 지침

- 이 프로젝트는 App Router를 사용하는 Next.js 15 앱입니다.
- 데이터베이스 액세스에는 Prisma를 사용합니다.
- 모든 API 경로는 Zod로 입력을 검증해야 합니다.
- 테스트는 Vitest를 사용합니다.
- npm이나 yarn이 아닌 pnpm을 사용하세요.

트러블슈팅

문제 상황	원인	해결 방법
"API key invalid"	잘못된 키 또는 만료됨	제공자 대시보드에서 키 재발급
확장 프로그램 로드 실패	VS Code 버전이 너무 낮음	VS Code를 최신 버전으로 업데이트
응답 속도 느림	큰 컨텍스트 또는 모델 속도	더 빠른 모델 사용, `@file:`로 컨텍스트 축소
파일 편집 미적용	권한 문제	VS Code 작업 영역 삭제(Trust) 설정 확인
터미널 명령 실패	쉘 감지 불가	설정에서 `kilocode.shell` 지정
과도한 토큰 사용	너무 많은 컨텍스트 전송	`@file:`로 제한, 불필요한 파일 닫기

Hypereal로 구축 시작하기

Kilo Code: 오픈 소스 AI 코딩 툴 (2026)

Kilo Code란 무엇인가요?

Kilo Code vs Cline vs Cursor

설치 방법

VS Code Marketplace에서 설치

커맨드 라인에서 설치

소스에서 설치 (기여자용)

설정

Step 1: Kilo Code 설정 열기

Step 2: AI 제공자 설정

Kilo Code 사용하기

기본 사용법

다중 파일 작업

터미널 명령

웹 브라우징

커스텀 모드 (Custom Modes)

내장 모드

커스텀 모드 생성하기

토큰 사용량 최적화

컨텍스트 관리

수동 컨텍스트 제어

비용 추적

설정 파일 레퍼런스

프로젝트별 지침

트러블슈팅

결론

관련 아티클

Aider AI: 터미널 기반 AI 코딩 어시스턴트 (2026)

Lovable 무료 제한 및 최고의 오픈 소스 대안 (2026년)

Claude Code 사용량을 모니터링하기 위한 최고의 오픈 소스 도구 (2026)

지금 바로 개발을 시작하세요

Hypereal로 구축 시작하기

Kilo Code: 오픈 소스 AI 코딩 툴 (2026)

Kilo Code란 무엇인가요?

Kilo Code vs Cline vs Cursor

설치 방법

VS Code Marketplace에서 설치

커맨드 라인에서 설치

소스에서 설치 (기여자용)

설정

Step 1: Kilo Code 설정 열기

Step 2: AI 제공자 설정

Kilo Code 사용하기

기본 사용법

다중 파일 작업

터미널 명령

웹 브라우징

커스텀 모드 (Custom Modes)

내장 모드

커스텀 모드 생성하기

토큰 사용량 최적화

컨텍스트 관리

수동 컨텍스트 제어

비용 추적

설정 파일 레퍼런스

프로젝트별 지침

트러블슈팅

결론

관련 아티클

Aider AI: 터미널 기반 AI 코딩 어시스턴트 (2026)

Lovable 무료 제한 및 최고의 오픈 소스 대안 (2026년)

Claude Code 사용량을 모니터링하기 위한 최고의 오픈 소스 도구 (2026)

지금 바로 개발을 시작하세요