Kimi Code CLI: A Beginner-Friendly Guide to Moonshot AI's Terminal Coding Agent

개요

Kimi Code CLI는 Moonshot AI에서 개발한 오픈소스 터미널 기반 AI 코딩 에이전트로, 코드 읽기 및 편집, 쉘 명령어 실행, 작업 단계별 수행 등 개발 생산성 향상을 위한 기능을 제공합니다.

주요 내용

* 기능: Kimi Code CLI는 터미널 내에서 직접 작동하며, 코드 수정, 쉘 명령어 실행, 코드베이스 검색, 외부 정보 검색, 작업 결과 기반의 다음 단계 결정 등의 기능을 수행합니다.
* 호환성: 기본적으로 Moonshot AI의 Kimi 모델과 호환되며, 설정 파일 수정을 통해 Anthropic, OpenAI, Google 등 다른 호환 가능한 LLM 제공업체와도 연동 가능합니다.
* 설치: TypeScript로 작성되었으며 MIT 라이선스로 배포됩니다. Node.js 설치 없이 단일 바이너리로 실행 가능하며, 공식 설치 스크립트 또는 npm/pnpm을 통해 설치할 수 있습니다.
* 차별점:
* 단일 바이너리 설치: Node.js, PATH 충돌, 글로벌 패키지 문제 없이 간편하게 설치 가능합니다.
* 빠른 시작: 터미널 UI(TUI)가 밀리초 단위로 로드됩니다.
* 영상 입력: 화면 녹화 영상을 입력하여 코드로 변환하거나 요약하는 기능이 제공됩니다.
* 대화형 MCP 설정: JSON 파일 수동 편집 없이 CLI와의 대화를 통해 Model Context Protocol(MCP) 서버를 추가하고 인증할 수 있습니다.
* 플러그인 생태계: 마켓플레이스 또는 GitHub 리포지토리에서 스킬, MCP 서버, 데이터 소스를 설치할 수 있습니다.
* 하위 에이전트(Subagents): 내장된 coder, explore, plan 하위 에이전트가 병렬로 실행되어 메인 대화를 깔끔하게 유지합니다.
* Lifecycle Hooks: 주요 지점에서 로컬 명령어를 실행하여 위험한 도구 호출을 차단하거나, 결정 사항을 로깅하거나, 데스크톱 알림을 트리거할 수 있습니다.
* 에디터 통합 (ACP): Agent Client Protocol(ACP)을 통해 Zed, JetBrains IDE 등 ACP 호환 클라이언트에서 Kimi Code CLI 세션을 제어할 수 있습니다.
* 설치 및 사용: macOS/Linux에서는 curl 명령어로, Windows에서는 PowerShell로 설치 스크립트를 실행하거나 Homebrew를 사용할 수 있습니다. npm/pnpm을 통한 설치도 가능합니다. 설치 후 kimi --version으로 확인하고, 프로젝트 디렉토리에서 kimi 명령어로 실행하여 /login 후 작업을 지시하면 됩니다.
* 유용한 명령어: /help, /new, /sessions, /model, /compact, /fork, /mcp-config, /exit 등이 있습니다.
* 데이터 저장 위치: 기본적으로 ~/.kimi-code/ 디렉토리에 설정 파일, 세션 기록, 로그, 업데이트 캐시 등이 저장되며, KIMI_CODE_HOME 환경 변수로 변경 가능합니다.
* 업그레이드 및 제거: kimi upgrade 명령어나 npm/pnpm을 통해 업그레이드할 수 있으며, 설치 방법에 따라 실행 파일을 삭제하거나 npm/pnpm으로 제거합니다.
* 소스 빌드: GitHub 리포지토리에서 클론 후 Node.js 및 pnpm을 사용하여 빌드할 수 있습니다.

시사점

Kimi Code CLI는 단일 바이너리 설치, 깨끗한 TUI, 하위 에이전트, MCP 지원, ACP를 통한 에디터 통합 등 기존 터미널 기반 AI 코딩 에이전트의 장점을 결합했으며, 특히 영상 입력 기능과 대화형 MCP 설정은 유사 도구와 차별화되는 특징을 제공합니다.