TL;DR

Kimi CLI는 터미널 기반 AI 에이전트로서 코드 읽기·수정과 셸 명령 실행을 단일 세션에서 처리하고 ACP와 MCP 표준을 통해 에디터 통합 및 외부 컨텍스트 연동을 지원한다. 사용자는 Ctrl-X로 셸 모드 전환, zsh 플러그인과 VS Code 확장을 통한 편의성 향상, kimi mcp 명령군 또는 --mcp-config-file 옵션을 통한 외부 MCP 서버 연결 같은 기능을 통해 개발 워크플로를 통합할 수 있다. 현재 프로젝트는 Kimi Code CLI로의 이관 계획을 공지했고 기존 구성과 세션을 자동 마이그레이션하므로 신규 제품군으로의 전환이 예정되어 있다.

주요 기능

• 코드베이스를 읽고 수정하며 터미널 명령을 실행하는 기능을 제공한다. 이 기능은 사용자가 터미널을 떠나지 않고 코드 변경과 셸 작업을 병행할 수 있게 한다. Ctrl-X로 전환하는 셸 명령 모드는 터미널 명령을 직접 입력해 실행하는 워크플로를 지원한다.
• IDE와의 통합을 위해 Agent Client Protocol(ACP)을 기본 지원한다. 사용자는 Kimi CLI를 ACP 에이전트 서버로 등록해 VS Code나 Zed, JetBrains 같은 에디터에서 스레드를 생성하고 에이전트 기능을 호출할 수 있다. ACP 통합은 에디터 내부에서 터미널 에이전트의 입출력을 편리하게 연결한다.
• MCP(Model Context Protocol) 서버를 등록·관리해 외부 컨텍스트 소스를 연결할 수 있다. kimi mcp 하위명령으로 서버를 추가·삭제·인증하고, --mcp-config-file 옵션으로 ad-hoc 구성 파일을 지정해 연결을 자동화한다. MCP 지원은 로컬 컨텍스트 한계를 넘는 외부 컨텍스트 연동을 가능하게 한다.
• 셸 플러그인과 확장으로 사용 환경을 확장할 수 있다. zsh-kimi-cli 플러그인 설치로 Zsh와 연동해 에이전트 모드를 전환할 수 있고 VS Code 확장으로 에디터 내에서 제안된 변경을 diff 뷰에서 검토할 수 있다. 이들 통합은 다양한 개발 환경에서 동일한 에이전트 경험을 유지하게 해 준다.

어떻게 동작하는가

Kimi CLI는 터미널에서 독립적으로 실행되는 에이전트 프로세스로 동작하며 내부에서 코드 읽기·편집 명령과 셸 명령 실행을 순차적으로 처리한다. ACP 호환 클라이언트와 통신할 때는 'kimi acp' 명령으로 에이전트 서버 모드를 활성화해 JSON 형식의 agent_servers 설정을 통해 에디터와 연결한다. MCP 연동 시에는 kimi mcp 명령군으로 HTTP 또는 stdio 기반 MCP 서버를 등록하고, 필요하면 --mcp-config-file로 미리 정의된 MCP 구성을 불러와 외부 컨텍스트 소스를 스트리밍 방식으로 사용한다.

해결 문제

로컬 터미널 환경에서 코드 편집·디버그·셸 명령 실행을 하나의 에이전트 워크플로로 통합하는 문제를 해결한다. 이 도구는 에디터를 오가며 수작업으로 수행하던 코드 수정과 셸 조작을 에이전트의 명령 실행과 연계해 단일 세션에서 수행할 수 있게 한다. 또한 ACP와 MCP 통합을 통해 에디터 내 에이전트 운영과 외부 컨텍스트 연동이라는 이종 도구 통합 문제를 완화한다.

지금 주목받는 이유

레포 자체에서 Kimi Code CLI로의 전환 계획을 공지하며 프로젝트가 차세대 터미널 에이전트 제품군으로 이동하고 있어 주목을 받는다. 이 전환은 기존 설치와 세션 설정이 자동으로 마이그레이션된다는 점에서 설치자들이 신규 제품군으로 옮겨갈 가능성을 높인다. 또한 ACP 및 MCP 같은 표준 통합을 강조해 에디터·컨텍스트 연동 시나리오에서 실무적 관심을 끌고 있다.

차별점

• 터미널 셸 모드를 내장해 Ctrl-X 키로 셸 입력과 에이전트 명령 간 전환이 가능하다.
• Agent Client Protocol(ACP)을 통해 VS Code, Zed, JetBrains 등 에디터에서 에이전트를 직접 연결할 수 있어 에디터 내 작업 흐름과 자연스럽게 통합된다.
• Model Context Protocol(MCP) 서버를 직접 관리하는 명령군을 제공해 외부 컨텍스트 제공자와 스트리밍 방식으로 연동할 수 있다.
• zsh 플러그인과 VS Code 확장을 통해 다양한 개발 환경에서 동일한 에이전트 인터페이스를 유지하도록 설계되었다.

사용 사례

• 로컬 터미널에서 바로 코드를 읽고 수정하며 변경 결과를 셸 명령으로 실행해 빠르게 검증하는 경우에 유용하다. 예컨대 간단한 리팩터링 후 테스트 실행과 로그 확인을 동일한 에이전트 세션에서 연속으로 수행할 수 있다. 이 방식은 반복적인 명령 전환으로 인한 맥락 손실을 줄여 준다.
• IDE 통합을 통해 에디터 안에서 에이전트 스레드를 만들고 제안된 변경 사항을 diff 뷰에서 검토하는 워크플로에 적합하다. ACP 구성을 통해 VS Code나 JetBrains 환경에서 Kimi CLI를 에이전트 서버로 등록하면 에디터 내에서 대화형 에이전트 작업을 수행할 수 있다. 이 패턴은 코드 리뷰나 자동 수정 제안과 결합될 때 실무 생산성을 향상시킨다.
• 외부 컨텍스트 제공자와 연동해 긴 문맥이 필요한 작업을 처리할 때 MCP를 활용할 수 있다. MCP 서버를 추가해 모델 컨텍스트를 스트리밍하면 로컬 토큰 한계를 넘는 문맥을 에이전트가 참조할 수 있다. 문서 기반 검색 결과나 대규모 코드베이스 메타데이터를 외부로부터 실시간으로 주입하는 시나리오에서 특히 유용하다.

시작하기

공식 문서의 'Getting Started' 가이드에 따라 설치와 초기 설정을 진행하도록 안내한다. 개발 환경에서 작업하려면 저장소를 클론한 뒤 make prepare로 개발 환경을 준비하고, uv run kimi로 로컬에서 에이전트를 실행해 테스트할 수 있다. 웹 UI를 포함해 패키지를 빌드하려면 make build-web 및 make build 또는 make build-bin 명령을 사용해야 하며 이 과정에서 Node.js/npm가 필요하다.

요구사항

• Python 런타임이 필요하며 저장소의 개발 지침에 맞춰 개발 환경을 준비해야 한다.
• 웹 UI를 빌드하거나 패키지 빌드가 필요한 경우 Node.js와 npm이 요구된다.
• ACP 통합을 사용하려면 ACP 호환 에디터 측 설정이 필요하며 에디터 설정에 Kimi CLI 실행 명령(kimi acp)을 등록해야 한다.

이미지 분석