만약 여러분이 Claude Code나 이와 유사한 터미널 기반 AI 에이전트들을 사용해 본 적이 있다면, Kimi Code CLI가 익숙하게 느껴질 것입니다. 이는 여러분의 터미널 내에 상주하며 코드를 읽고 수정하며, 셸 명령 (shell commands)을 실행하고, 얻어낸 결과에 따라 단계별로 작업을 수행하는 Moonshot AI의 오픈 소스 (open-source) 코딩 에이전트입니다.

이 포스트에서는 Kimi Code CLI가 무엇인지, 왜 여러분에게 유용할 수 있는지 설명하고, 처음 설치하여 사용하는 과정을 안내합니다.

Kimi Code CLI란 무엇인가

Kimi Code CLI는 터미널에서 직접 실행되는 AI 코딩 에이전트입니다. 채팅창과 에디터 사이에서 코드를 복사하여 왔다 갔다 하는 대신, 여러분이 일상 언어로 작업을 설명하면 에이전트가 다음과 같은 일을 수행합니다:

• 프로젝트 내의 파일을 읽고 수정
• 셸 명령 (shell commands) 실행
• 코드베이스 (codebase) 검색
• 외부 정보가 필요할 때 웹 페이지 가져오기
• 고정된 스크립트를 따르는 대신, 얻은 출력값에 기반하여 다음 단계 결정

이 도구는 Moonshot AI의 Kimi 모델들과 즉시 연동되어 작동하며, 설정 파일 (config file)을 편집하여 Anthropic, OpenAI 또는 Google과 같은 다른 호환 가능한 제공업체로 지정할 수도 있습니다.

이 프로젝트는 TypeScript로 작성되었으며, MIT 라이선스 (MIT licensed)를 따르고, 단일 바이너리 (single binary)로 배포되므로 이를 실행하기 위해 별도의 Node.js 설정이 필요하지 않습니다.

차별점

이미 터미널 기반 AI 에이전트를 사용 중이거나 첫 에이전트를 찾고 있다면, 다음과 같은 몇 가지 설계 선택 사항들이 이 도구를 시도해 볼 가치가 있게 만듭니다:

• 단일 바이너리 설치 (Single-binary install). Node.js가 필요 없고, PATH 충돌이 없으며, 글로벌 패키지 혼란도 없습니다. 스크립트 하나면 끝납니다.
• 빠른 시작 (Fast startup). 터미널 UI (TUI)가 밀리초 단위로 로드됩니다.
• 비디오 입력 (Video input). 채팅창에 화면 녹화 파일을 드롭하면, 에이전트가 이를 작동하는 코드로 변환하거나 짧은 요약본으로 만들 수 있습니다. 이는 코딩 에이전트들 사이에서 흔치 않은 기능입니다.
• 대화형 MCP 설정 (Conversational MCP setup). JSON 파일을 직접 편집하는 대신, /mcp-config를 통해 CLI와 대화함으로써 Model Context Protocol (MCP) 서버를 추가하고 인증할 수 있습니다.
• 플러그인 생태계 (Plugin ecosystem). 마켓플레이스나 GitHub 리포지토리에서 직접 기술(skills), MCP 서버, 데이터 소스를 설치할 수 있으며, 각 항목의 신뢰 수준이 사전에 표시됩니다.
• 하위 에이전트 (Subagents). 내장된 coder, explore, plan 하위 에이전트들이 격리된 컨텍스트에서 병렬로 실행되어, 메인 대화창을 깔끔하게 유지할 수 있습니다.
• 라이프사이클 훅 (Lifecycle hooks). 위험한 도구 호출을 차단하거나, 결정을 로그로 남기거나, 데스크톱 알림을 트리거하는 등 주요 시점에 로컬 명령을 실행할 수 있습니다.
• ACP를 통한 에디터 통합 (Editor integration via ACP). Agent Client Protocol (ACP)을 사용하여 Zed, JetBrains IDEs 또는 기타 ACP 호환 클라이언트에서 Kimi Code CLI 세션을 제어할 수 있습니다.

Kimi Code CLI 설치하기

두 가지 주요 설치 경로가 있습니다: 공식 설치 스크립트 또는 npm입니다.

옵션 1: 설치 스크립트 (권장)

macOS 또는 Linux

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows (PowerShell)

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Windows의 경우, Kimi Code CLI가 번들된 Git Bash를 셸 환경으로 사용하므로 먼저 Git for Windows를 설치하십시오. 만약 Git Bash가 표준 위치가 아닌 곳에 있다면, KIMI_SHELL_PATH 환경 변수를 bash.exe의 전체 경로로 설정하십시오.

Homebrew (macOS/Linux)

brew install kimi-code

스크립트는 최신 릴리스를 다운로드하고, 체크섬(checksum)을 검증하며, kimi 실행 파일을 PATH에 추가합니다.

옵션 2: npm을 통한 설치

이미 Node.js 22.19.0 이상의 버전을 사용 중이라면:

node --version
npm install -g @moonshot-ai/kimi-code

또는 pnpm을 사용하여:

pnpm add -g @moonshot-ai/kimi-code

설치 확인

새 셸 세션(shell session)을 열고 다음을 실행합니다:

kimi --version

버전 번호가 출력된다면, 모든 준비가 완료되었습니다.

첫 실행 및 로그인

프로젝트 디렉터리로 이동하여 대화형 UI (interactive UI)를 시작합니다:

cd your-project
kimi

처음 실행할 때, CLI 내부에서 로그인합니다:

/login

그러면 두 가지 옵션이 있는 플랫폼 선택창이 열립니다:

• Kimi Code (OAuth) — 디바이스 코드 흐름 (device-code flow) 방식입니다. 어떤 기기에서든 링크를 열어 로그인한 후, 코드를 입력하여 인증합니다.
• Kimi Platform API key — platform.kimi.com 또는 platform.kimi.ai에서 발급받은 키를 붙여넣습니다.

나중에 로그아웃하려면 /logout을 실행하세요.

만약 Anthropic, OpenAI, Google 또는 다른 호환 가능한 제공업체를 사용하고 싶다면, ~/.kimi-code/config.toml 파일을 직접 편집하여 API 키를 추가하면 됩니다.

첫 번째 작업 시도하기

로그인이 완료되면, 원하는 내용을 평이한 영어로 설명하기만 하면 됩니다. 프로젝트를 탐색하도록 하는 것이 좋은 첫 번째 프롬프트(prompt) 예시입니다:

Take a look at this project's directory structure and briefly describe what each directory is for.

Kimi Code CLI는 답변하기 전에 문맥(context)을 수집하기 위해 파일 읽기 및 검색 도구를 자동으로 호출합니다. 읽기 전용 작업은 확인 절차 없이 실행됩니다. 파일을 수정하거나 셸 명령(shell commands)을 실행하는 모든 작업은 먼저 승인을 요청하는 프롬프트가 나타납니다.

구체적인 코딩 작업을 맡길 수도 있습니다:

Add a function in src/utils that converts any string to kebab-case, and add a unit test for it.

에이전트(agent)는 단계를 계획하고, 코드를 수정하며, 테스트를 실행한 뒤 수행한 내용을 보고합니다.

대화형 UI 없이 단일 명령 실행하기

kimi -p "Take a look at this project's directory structure"

이전 세션 재개하기

kimi -c

알아두면 유용한 명령어

유용한 키보드 단축키:

에디터 내부에서 사용하기 (ACP)

Kimi Code CLI는 Agent Client Protocol (ACP)을 지원하여, Zed나 JetBrains와 같은 에디터가 세션을 직접 제어할 수 있도록 합니다.

Zed의 경우, ~/.config/zed/settings.json에 다음을 추가하세요:

{
  "agent_servers": {
    "Kimi Code CLI": {
...

그 다음 Zed의 Agent 패널에서 새로운 대화를 시작하세요. 기존 CLI 자격 증명 (credentials)을 재사용하므로 별도의 로그인은 필요하지 않습니다.

데이터 저장 위치

Kimi Code CLI는 기본적으로 설정 파일, 세션 기록, 로그 및 업데이트 캐시를 ~/.kimi-code/ 아래에 저장합니다. 이를 다른 곳으로 옮기려면 KIMI_CODE_HOME 환경 변수를 다른 경로로 설정하세요.

업그레이드 및 삭제

업그레이드

kimi upgrade

또는 npm을 통해 설치한 경우:

npm install -g @moonshot-ai/kimi-code@latest

삭제

스크립트를 통해 설치했다면 kimi 실행 파일을 삭제하기만 하면 됩니다. npm을 통해 설치한 경우:

npm uninstall -g @moonshot-ai/kimi-code

소스 코드로 빌드하기

기여하거나 main 브랜치의 최신 코드를 실행하고 싶다면:

git clone https://github.com/MoonshotAI/kimi-code.git
cd kimi-code
pnpm install

pnpm dev:cli    # 개발 모드에서 CLI 실행
pnpm test       # 테스트 실행
pnpm typecheck  # TypeScript 체크
...

이를 위해서는 Node.js 24.15.0 이상과 pnpm 10.33.0이 필요합니다. 전체 기여 가이드는 저장소의 CONTRIBUTING.md를 확인하세요.

마무리

Kimi Code CLI는 사람들이 이미 터미널 기반 AI 코딩 에이전트에서 선호하는 많은 요소들을 결합했습니다: 빠른 단일 바이너리 설치, 깔끔한 TUI, 하위 에이전트 (subagents), MCP 지원, 그리고 ACP를 통한 에디터 통합입니다. 비디오 입력 기능과 대화형 MCP 설정은 유사한 도구들과 진정으로 차별화되는 두 가지 특징입니다.

직접 사용해보고 싶다면, 설치 스크립트를 실행한 후 /login을 입력하는 것이 가장 빠른 방법입니다. 그 다음부터는 원하는 작업 내용을 설명하기만 하면 됩니다.

링크

• 리포지토리 (Repository): https://github.com/MoonshotAI/kimi-code