Kilo Code 튜토리얼: 설정, 무료 크레딧, Roo 마이그레이션
Roo Code 커뮤니티를 이어받은 AI 코딩 에이전트입니다. VS Code에 설치하고, $20 보너스 크레딧을 받고, 내 API 키로 DeepSeek를 직접 연결하고, Roo 환경이 완전히 멈추기 전에 마이그레이션을 끝내세요.
핵심 요약
- Roo Code는 2026년 4월 21일 서비스 종료를 발표했고 VS Code 확장은 5월 15일에 중단됐습니다. Roo의 포크인 Kilo Code가 300만 설치의 공식 마이그레이션 목적지입니다.
- 확장은 오픈소스이고 자신의 API 키(BYOK)를 쓰면 영구 무료입니다. 신규 계정은 첫 충전 시 $20 보너스 크레딧과 신용카드 없이도 되는 14일 엔터프라이즈 체험을 받습니다.
- DeepSeek 직접 연결: Settings → Providers에서 DeepSeek API 키를 넣고 base URL은 https://api.deepseek.com, 모델은 deepseek-flash 또는 deepseek-v4-pro를 고르세요.
- 마이그레이션은 반자동입니다. Roo 설정 파일 이름을 바꾸고, 마이그레이션 마법사로 변환하고, 최소한의 kilo.jsonc를 작성하세요. 그리고 API 키는 이전되지 않으므로 모든 프로바이더를 다시 인증해야 합니다.
Just Signed Up? Your first 14 minutes with Kilo Code
워크스루 영상:Kilo (official)14:02
How to Migrate from Roo to Kilo
마이그레이션 영상:Kilo (official)2:07
워크스루 영상은 2025년 6월 촬영으로, OpenCode 기반 재작성(2026년 4월 2일 GA) 이전의 구버전 UI입니다. 메뉴 위치는 바뀌었지만 흐름은 같습니다. 마이그레이션 영상은 현재 UI입니다.
스크린샷은 Kilo 공식 YouTube 영상의 프레임이며, 출처를 밝히고 각 단계에서 원본 영상의 해당 시점으로 연결됩니다. 본문은 이 사이트의 자체 저작입니다.
Kilo Code 설정과 마이그레이션, 단계별 가이드
1 · Kilo Code 알아보기(Roo 사용자가 떠나는 이유)
- 1
배경부터 이해하기: Roo Code는 종료 중입니다
2026년 4월 21일 Roo Code 팀은 확장을 종료하고 Roomote에 전력을 다한다고 발표했습니다. VS Code 확장은 5월 15일에 중단됐고 GitHub 저장소는 읽기 전용 아카이브가 됐습니다. Roo의 포크인 Kilo Code는 공식 작별 글을 발행하며 약 300만 설치의 새로운 안식처가 되었습니다.
서비스 종료 발표 화면. 댓글창에는 Kilo 메인테이너가 이미 답변을 남겼습니다0:04 장면 보기 - 2
다섯 가지 인터랙션 모드 알아보기
Kilo Code에는 다섯 가지 모드가 있습니다. Code는 구현, Architect는 코딩 전 계획, Ask는 설명, Debug는 오류 추적, Orchestrator는 큰 작업을 하위 작업으로 분할합니다. 커스텀 모드도 만들 수 있으며, Roo의 커스텀 모드는 마이그레이션 때 여기로 매핑됩니다.
모드 선택기는 Kilo Code 패널의 프롬프트 입력창 바로 위에 있습니다0:22 장면 보기 - 3
프롬프트 하나로 무엇이 만들어지는지 보기
공식 온보딩 워크스루에서는 앱 목적·데이터 구조·정렬과 검색 동작·UI 디자인을 적은 프롬프트 하나로 동작하는 노트 정리 앱(단일 HTML 파일)이 만들어졌고, Kilo가 이를 브라우저에서 열어줬습니다. 생성 비용은 API 크레딧 약 3센트였습니다.
완성된 노트 정리 앱: 카드, 태그, 검색, 정렬까지 프롬프트 하나로5:06 장면 보기 - 4
Architect 모드에게 질문하게 하기
무엇을 지정해야 할지 모르겠다면 Architect 모드가 거꾸로 물어봅니다. 체스 게임 예에서는 규칙 수준, 일대일 대전 여부, AI 강도를 클릭형 선택지로 물었습니다. 완성된 계획(아키텍처 다이어그램 포함)은 markdown 파일로 저장된 뒤 Code 모드가 구현합니다.
Architect 모드는 막연한 아이디어를 답하기 쉬운 선택지로 바꿔줍니다8:12 장면 보기
2 · 확장 설치하고 $20 크레딧 받기
- 5
Kilo Code 확장 설치하기
VS Code 마켓플레이스에서 "Kilo Code"를 검색하거나 화면의 명령어를 실행하세요: code --install-extension kilocode.Kilo-Code. 확장은 오픈소스이며 VS Code, JetBrains, 독립 CLI를 지원합니다.
공식 마이그레이션 영상의 한 줄 터미널 설치 명령0:10 장면 보기 - 6
가입 크레딧 챙기기
가입 직후 무료 크레딧이 충전된 Kilo Code 호스팅 API 프로필이 생깁니다. 아래 워크스루에는 "$20 for free" 문구가 보이고, kilo.ai/pricing에도 첫 충전 시 $20 보너스와 신용카드 없는 14일 엔터프라이즈 체험이 안내되어 있습니다. BYOK은 영구 무료입니다.
Settings → Providers: 기본 Kilo Code 프로필과 $20 가입 크레딧1:18 장면 보기
3 · 내 키로 DeepSeek 연결하기
- 7
내 키용 프로바이더 프로필 추가하기
Settings → Providers를 열고 +를 눌러 New Configuration Profile을 만드세요. "DeepSeek"나 "OpenRouter" 같은 이름을 붙이면 기본 프로필을 건드리지 않고도 메인 패널에서 전환할 수 있는 두 번째 프로필이 생깁니다.
OpenRouter라는 이름의 두 번째 설정 프로필 만들기1:46 장면 보기 - 8
API 키 붙여넣고 모델 고르기
프로바이더 유형을 고르고 API 키를 붙여넣은 뒤 모델을 선택합니다. DeepSeek 직접 연결은 kilo.ai/docs/ai-providers/deepseek의 안내를 따라 base URL에 https://api.deepseek.com을 넣고, 일상 코딩은 deepseek-flash, 무거운 추론은 deepseek-v4-pro를 고르세요. 키는 VS Code의 SecretStorage에 안전하게 저장됩니다.
프로바이더 유형, API 키, 모델 — DeepSeek 공식 Kilo 가이드가 채우는 바로 그 세 항목입니다1:52 장면 보기
4 · Roo Code에서 마이그레이션
- 9
Roo 작업공간 파일 이름 바꾸기(저장소마다)
마이그레이션 마법사는 Roo 접두사 파일을 읽지 않으므로 Kilo 마이그레이션 가이드의 명령으로 먼저 옮깁니다: .roorules → AGENTS.md, .roo/rules/* → .kilo/rules/, .roomodes → .kilocodemodes, .roo/mcp.json → .kilocode/mcp.json, .rooignore → .kilocodeignore. 시작 전에 Roo의 globalStorage 폴더 백업도 잊지 마세요.
공식 포팅 스크립트: 저장소마다 다섯 개의 복사·이름 변경 명령0:34 장면 보기 - 10
최소한의 kilo.jsonc 작성하기
kilo.jsonc는 Roo의 도구 그룹을 명시적 권한으로 바꿉니다. 모든 작업이 allow, ask, deny 셋 중 하나이며 경로 패턴을 붙일 수 있습니다. 마이그레이션 가이드의 최소 예제를 복사하고 모델을 정한 뒤 instructions에 규칙 파일을 나열하세요.
kilo.jsonc: 모델 선택과 읽기·쓰기·bash 명령별 권한1:10 장면 보기 - 11
kilo config check로 검증하기
터미널에서 kilo config check를 실행해 마이그레이션된 설정이 파싱되고 참조 파일이 모두 존재하는지 확인합니다. 확장을 처음 띄울 때 마이그레이션 마법사가 레거시 파일도 자동 변환합니다. .kilocodemodes는 정식 에이전트 markdown 파일로 바뀌고 .kilo/rules는 폴백으로 남습니다.
명령 하나로 마이그레이션된 설정의 유효성 확인1:15 장면 보기 - 12
검증 후 Roo는 비활성화(삭제는 금물)
저장소를 열고 Code 에이전트를 골라 로드된 커스텀 에이전트와 규칙을 나열해 달라고 요청하세요. 답변에 마이그레이션된 에이전트, 규칙, 모델, 권한이 나와야 합니다. 이상이 없으면 확장 패널에서 Roo를 비활성화하고 한 주 정도 폴백으로 두었다가 삭제하세요.
검증 답변에는 Kilo가 로드한 에이전트, 규칙, 모델, 권한이 모두 나열됩니다1:36 장면 보기
한눈에 보는 Kilo Code vs Roo Code
| 항목 | Kilo Code | Roo Code |
|---|---|---|
| 현황 | 운영 중. Roo 사용자의 공식 마이그레이션 대상 | 2026년 4월 21일 종료 발표, 확장은 5월 15일부터 중단 |
| 계보 | Roo Code의 포크(Roo 자체는 Cline에서 파생). 독립 회사가 개발 계승 | Cline의 포크. 원 팀은 Roomote로 이동 |
| 현재 확장 | OpenCode 서버 기반으로 재구축(2026년 4월 2일 GA). JetBrains, CLI, 클라우드 버전도 제공 | 레거시 v5.x 라인은 종료와 함께 동결. GitHub 저장소는 읽기 전용 아카이브 |
| 마이그레이션 경로 | 이름 변경 + 마법사 방식, kilo.jsonc 권한, 프로바이더 재인증 필요 | 없음 — 작업공간 파일은 .roo 경로에 그대로. 결제 문의는 billing@roocode.com |