Kilo-Org/kilocode

Kilo는 올인원 에이전트 엔지니어링 (agentic engineering) 플랫폼입니다. 가장 인기 있는 오픈 소스 코딩 에이전트와 함께 더 빠르게 구축하고, 배포하고, 반복하세요.

• ✨ 자연어 (natural language)로부터 코드 생성

• ✅ 자체 작업 검증

• 🧪 터미널 명령 실행

• 🌐 브라우저 자동화

• ⚡ 인라인 자동 완성 (Inline autocomplete) 제안

• 🤖 최신 AI 모델

• 🎁 API 키 선택 사항

• VS Code Marketplace (다운로드)

• CLI 설치:
  npm install -g @kilocode/cli

• 공식 Kilo.ai 홈페이지 (자세히 알아보기)

코드 생성 (Code Generation): Kilo는 자연어를 사용하여 코드를 생성할 수 있습니다.
인라인 자동 완성 (Inline Autocomplete): AI를 통해 타이핑하는 동안 지능적인 코드 완성을 제공받으세요.
작업 자동화 (Task Automation): Kilo는 반복적인 코딩 작업을 자동화하여 시간을 절약할 수 있습니다.
자동 리팩토링 (Automated Refactoring): Kilo는 기존 코드를 효율적으로 리팩토링하고 개선할 수 있습니다.
MCP 서버 마켓플레이스 (MCP Server Marketplace): Kilo는 에이전트 기능을 확장하기 위해 MCP 서버를 쉽게 찾고 사용할 수 있습니다.
멀티 모드 (Multi Mode): Architect로 계획하고, Coder로 코딩하며, Debugger로 디버깅하세요. 또한 자신만의 커스텀 모드를 만들 수 있습니다.

• VS Code Marketplace에서 Kilo Code 확장 프로그램을 설치하세요.
• 계정을 생성하여 GPT-5.5, Claude Opus 4.7, Claude Sonnet 4.6, Gemini 3.1 Pro Preview를 포함한 500개 이상의 최첨단 AI 모델에 액세스하세요. 제공업체의 요율과 정확히 일치하는 투명한 가격 정책이 적용됩니다.
• 워크플로우에 적응하는 AI와 함께 코딩을 시작하세요. Kilo가 작동하는 모습은 퀵스타트 가이드를 통해 확인하실 수 있습니다:

# npm
npm install -g @kilocode/cli
# 또는 npx로 직접 실행
...

그 다음, 시작하려면 모든 프로젝트 디렉토리에서 kilo를 실행하세요.

npm 설치 참고 사항: 숨겨진 .kilo 파일

일부 시스템 및 npm 버전에서는 @kilocode/cli를 설치할 때 설치된 kilo 명령 근처(예: 글로벌 npm bin 디렉토리)에 숨겨진 .kilo 파일이 생성될 수 있습니다. 이 파일은 npm에서 생성한 런처 헬퍼 (launcher helper)이며, 프로젝트 데이터가 아닙니다.

• 존재 이유: npm이 CLI 실행 파일 (executables)을 연결하는 과정에서 헬퍼 아티팩트 (helper artifacts)를 생성할 수 있습니다.
• 크기 주의사항: 크기는 플랫폼, npm 버전, 설치 모드 (심볼릭 링크 (symlink) vs 복사된 런처 (copied launcher))에 따라 달라질 수 있으므로, 엄격하게 고정된 크기를 보장하지 않습니다.
• 안전성: 그대로 두어도 안전합니다. 수동으로 편집하지 마세요. 설치된 아티팩트를 깔끔하게 제거하려면 패키지 관리자의 삭제 명령 (npm uninstall -g @kilocode/cli)을 사용하세요.

Releases 페이지에서 최신 바이너리 (binary) 또는 소스 코드 (source code)를 다운로드하세요. 다음 빠른 가이드를 참고하십시오:

kilo-<os>-<arch>.zip은 Windows 및 macOS 환경의 OS 및 CPU 아키텍처 (architecture)에 맞는 CLI 바이너리입니다. (Linux의 경우 kilo-linux-<arch>.tar.gz)
darwin은 macOS를 의미합니다.
x64는 표준 64비트 Intel/AMD CPU입니다.
x64-baseline은 이전 세대 x64 CPU를 위한 호환성 빌드입니다 (AVX 명령어 (Instruction)를 지원하지 않음).
arm64는 ARM 기반의 Linux/macOS입니다.
musl은 glibc가 없는 Alpine/최소형 (minimal) Docker를 위한 정적 링크 (statically linked) Linux 빌드입니다. Alpine/최소형 Docker 사용자는 이에 맞는 *-musl 자산을 사용하는 것이 좋습니다.
kilo-vscode-*.vsix는 VS Code 확장 프로그램 (extension) 패키지이며 CLI 바이너리가 아닙니다.
Source code 릴리스는 소스에서 빌드하기 위한 용도이며, 일반적인 설치용이 아닙니다.

대부분의 사용자:

Windows (대부분의 PC): kilo-windows-x64.zip

macOS Apple Silicon: kilo-darwin-arm64.zip

macOS Intel: kilo-darwin-x64.zip

Linux x64: kilo-linux-x64.tar.gz

Linux on ARM: kilo-linux-arm64.tar.gz

사용자 상호작용 없이 완전히 자율적인 동작 (autonomous operation)을 활성화하려면 kilo run 실행 시 --auto 플래그 (flag)를 사용하세요. 이는 CI/CD 파이프라인 및 자동화된 워크플로 (workflows)에 이상적입니다:

kilo run --auto "run tests and fix any failures"

중요: --auto 플래그는 모든 권한 확인 프롬프트 (permission prompts)를 비활성화하며, 에이전트 (agent)가 확인 절차 없이 어떤 동작이든 실행할 수 있도록 허용합니다. CI/CD 파이프라인과 같이 신뢰할 수 있는 환경에서만 사용하십시오.

개발자, 작가, 그리고 열정적인 분들의 기여를 환영합니다! 시작하려면 기여 가이드 (Contributing Guide)를 읽어주세요. 여기에는 환경 설정, 코딩 표준 (coding standards), 기여 유형, 그리고 풀 리퀘스트 (pull requests) 제출 방법에 대한 자세한 내용이 포함되어 있습니다.

VS Code 확장 프로그램 및 CLI 출시 프로세스는 RELEASING.md를 참조하십시오.

JetBrains 플러그인 출시 프로세스는 packages/kilo-jetbrains/RELEASING.md를 참조하십시오.

우리 커뮤니티는 존중, 포용성, 그리고 협업을 바탕으로 구축되었습니다. 모든 기여자 및 커뮤니티 구성원에게 요구되는 기대 사항을 이해하려면 행동 강령 (Code of Conduct)을 검토해 주시기 바랍니다.

이 프로젝트는 MIT 라이선스 (MIT License) 하에 라이선스가 부여됩니다. 적절한 출처 표기 및 라이선스 고지를 포함하는 한, 상업적 목적을 포함하여 이 코드를 자유롭게 사용, 수정 및 배포할 수 있습니다. License를 참조하십시오.