Kilo Code: 에디터 안에서 동작하는 오픈소스 AI 코딩 에이전트

Kilo Code는 VS Code, JetBrains 계열 IDE, 명령줄에서 사용할 수 있는 오픈소스 AI 코딩 확장입니다. 코드를 채팅창에 붙여 넣게 하는 대신 프로젝트 안으로 들어갑니다. 관련 파일을 읽고, 변경 계획을 제시하고, 적용하려는 변경 사항을 diff 형태로 보여 주며, 승인한 뒤에만 명령을 실행합니다. 제공사는 "모든 개발자 워크플로에 맞는 하나의 오픈 에이전트"라고 위치를 설명합니다.

이 차이는 단순히 코드를 생성할 수 있는지보다 중요합니다. AI 개발 지원에서 어려운 부분은 그럴듯한 함수를 만드는 일이 아니라, 변경이 올바른 파일에 들어가고 주변 관례를 따르며 나중에 리뷰 가능한 상태로 남는 일입니다. Kilo Code의 기능은 이 순환을 중심으로 설계되었고, 공개 저장소와 자체 API 키(BYOK) 지원을 통해 모델 선택권과 데이터 흐름을 사용자에게 돌려줍니다.

주요 기능

코드 생성과 수정: 자연어로 작업을 설명하면 새 코드를 작성하거나 기존 파일을 정밀하게 수정합니다. 변경은 diff로 제시되어 하나씩 승인하거나 거절할 수 있고, 파일 전체를 덮어쓰지 않습니다.

모드 전환: Code 모드는 구현, Architect 모드는 설계와 기술 문서, Debug 모드는 결함 추적과 수정을 담당합니다. 모드 전환은 모델에 주어지는 제약 집합을 바꾸는 것에 가까워, 탐색과 구현이 뒤섞이는 일을 줄입니다.

코드베이스 질의: 어떤 함수가 어디서 호출되는지, 특정 설정이 왜 존재하는지, 모듈이 어떻게 연결되는지 물을 수 있습니다. 인덱싱이 끝나면 답변에 파일 위치가 함께 나와 바로 확인할 수 있습니다.

작업 자동화: 파일 읽기와 쓰기, 터미널 명령 실행을 에이전트에 맡길 수 있습니다. 파괴적인 작업은 기본적으로 수동 승인이 필요하며, 규칙에 따라 자동 승인 범위를 넓힐 수도 있습니다.

코드 리뷰: 풀 리퀘스트를 분석해 개선안을 제시합니다. 사람이 보기 전에 기계적으로 한 번 걸러내는 용도로 유용합니다.

MCP 연동: Model Context Protocol을 통해 외부 도구, API, 사내 스크립트를 에이전트에 노출하고 같은 패널에서 호출할 수 있습니다.

모델 선택: 제공사는 500개 이상의 모델을 사용할 수 있다고 밝히며(이 수치는 벤더 페이지 기준), 작업 난이도에 따라 빠른 모델과 추론 중심 모델을 오갈 수 있습니다. 자체 API 키도 설정할 수 있습니다.

사용 방법

1. 확장 설치: VS Code 확장 패널(Ctrl+Shift+X 또는 Cmd+Shift+X)에서 "Kilo Code"를 검색해 설치합니다. Open VSX, .vsix 수동 설치, Cursor 확장 마켓플레이스를 통한 설치도 안내되어 있습니다.
2. 로그인: 사이드바의 Kilo Code 아이콘을 눌러 패널을 열고 가입 또는 로그인을 마칩니다.
3. 모델 선택: 설정에서 모델을 고르거나 자체 API 키를 지정합니다. 비용을 아끼려면 작은 모델로 먼저 시험하는 편이 좋습니다.
4. 작업 설명: 목표와 제약을 자연어로 적습니다. 예: "이 파이썬 스크립트에 인자 검증을 추가하고 테스트까지 붙여 줘".
5. 제안 검토: 에이전트가 읽을 파일, 수정할 위치, 실행할 명령을 나열합니다. 항목별로 승인하거나 거절합니다.
6. 반복 수렴: 결과에 피드백을 주며 의도에 맞을 때까지 조정합니다. 별도 브랜치에서 작업하면 되돌리기가 쉽습니다.

적합한 상황

• 프로토타이핑: 아이디어를 실행 가능한 골격으로 빠르게 옮겨 세부 구현 전에 구조를 검증합니다.
• 낯선 코드 유지보수: 인계받은 저장소에서 호출 관계를 파악하고 주석과 문서를 보강합니다.
• 리뷰 전 점검: 동료가 보기 전에 풀 리퀘스트를 에이전트에 통과시켜 뚜렷한 누락을 걸러냅니다.
• 학습: 특정 코드의 실행 경로를 설명하게 하고, 답변이 인용한 파일 위치와 대조해 확인합니다. 답을 그대로 베끼는 것보다 신뢰할 만합니다.
• 팀 규칙 적용: 스타일과 디렉터리 규칙을 에이전트 지침에 적어 생성 결과를 기존 관례에 가깝게 만듭니다.

한계와 확인할 점

• 비용은 사용량에 비례: 공개된 요금제는 개인 종량제, 팀은 사용자당 월 15달러, 기업은 별도 견적입니다. 종량제에서는 모델 호출량이 곧 청구서가 되고 긴 컨텍스트 작업은 비용이 빠르게 늘어나므로, 먼저 예산이나 한도를 설정하는 편이 안전합니다.
• 생성 결과는 사람이 검토해야 함: AI가 만든 코드에는 논리 오류, 폐기된 API, 보안 결함이 섞일 수 있습니다. 인증, 금액 계산, 데이터 삭제와 관련된 부분은 병합 전에 한 줄씩 확인해야 합니다.
• 모델 수 표기는 벤더 정보: 500개 이상 모델, 자동 완성, 병렬 에이전트 같은 설명은 공식 페이지의 내용입니다. 실제 사용 범위는 요금제, 계정, 지역에 따라 달라집니다.
• 데이터 흐름은 직접 평가해야 함: 호스팅 모델을 쓰면 코드 조각이 모델 제공사로 전송됩니다. 사내 코드를 다루는 팀은 자체 키, 프라이빗 게이트웨이, 기업용 감사 기능을 우선 검토하고 사내 컴플라이언스 기준에 맞춰 판단해야 합니다.
• 자료에 없는 부분: 이번 수집 자료에는 지연 시간이나 동시 처리 지표, 독립적인 제3자 평가가 포함되지 않았습니다. 성능은 자체 저장소에서 측정해야 합니다.

자주 묻는 질문

Kilo Code는 무료인가요? 소프트웨어 자체는 오픈소스이며 저장소는 github.com/Kilo-Org/kilocode에 있어 코드와 라이선스를 확인할 수 있습니다. 다만 모델 사용은 보통 유료입니다. 제공사는 개인 종량제, 팀 사용자당 월 15달러, 기업 별도 견적을 안내하며 최신 가격은 공식 사이트에서 확인해야 합니다.

VS Code에서만 쓸 수 있나요? 공식 문서는 VS Code, JetBrains 계열 IDE, 명령줄 인터페이스를 지원하며 Cursor 마켓플레이스나 Open VSX 설치도 언급합니다. 에디터별 기능 구성이 다를 수 있으므로 특정 기능에 의존한다면 릴리스 노트를 확인하세요.

채팅창에 코드를 붙이는 방식과 무엇이 다른가요? 컨텍스트와 실행 방식입니다. 확장은 프로젝트 파일을 직접 읽고 위치를 특정해 수정하며, 변경을 diff로 제시하고 명령 실행 전에 승인을 요청합니다. 붙여넣기 왕복이 사라지고 변경 추적이 쉬워집니다.

사내 프라이빗 코드에 사용할 수 있나요? 기술적으로는 가능하지만 먼저 컴플라이언스 검토가 필요합니다. 승인된 모델 제공사를 가리키는 자체 키 구성이나, 프라이빗 게이트웨이와 감사 로그를 갖춘 기업용 요금제를 선택하면 코드가 미승인 제3자에게 전달되는 것을 피할 수 있습니다.