TL;DR

Kimi Code CLI는 단일 바이너리 형태의 터미널 기반 AI 코드 에이전트로서 코드 읽기·편집, 셸 명령 실행, 파일 검색과 비디오 입력 처리 기능을 TUI로 제공한다. 모델 연결과 인증은 대화형 `/mcp-config`로 관리되며 ACP 서브커맨드를 통해 Zed나 JetBrains 같은 에디터와 stdio 기반으로 직접 통합할 수 있다. 사용자는 별도 Node.js 설치 없이 빠르게 시작할 수 있고 플러그인·서브에이전트·라이프사이클 훅을 통해 작업을 확장하거나 안전 검사와 자동화를 연결할 수 있다. 개발자 기여를 위해서는 Node.js ≥ 24.15.0과 pnpm 10.33.0이 요구되며 Windows에서는 Git Bash가 필요하다.

주요 기능

• 코드를 읽고 편집하며 로컬 파일과 셸을 통해 직접 변경을 적용한다.
• 비디오 입력을 받아 화면 녹화·데모 클립을 해석해 작업 참조로 전환한다.
• 대화형 `/mcp-config`로 Model Context Protocol 서버를 추가하고 인증을 관리한다.
• ACP를 통해 Zed나 JetBrains 같은 에디터에서 세션을 원격으로 제어한다.

어떻게 동작하는가

Kimi Code CLI는 단일 바이너리 형태의 TUI 기반 에이전트로 동작하여 사용자 입력에 따라 코드 수정, 셸 명령 실행, 파일 검색 같은 도구 호출을 순차적으로 수행한다. 모델 선택과 인증은 MCP 서버를 통해 대화형으로 구성되며 에이전트는 피드백을 받아 다음 단계를 결정하는 루프를 유지한다. ACP 서브커맨드는 에디터를 세션 클라이언트로 연결하여 stdio를 통해 명령을 주고받는 방식으로 통합을 실현한다.

해결 문제

로컬 개발 컨텍스트에서 대화형 에이전트를 띄우려면 여러 런타임과 복잡한 설정이 필요했고 에디터 연동도 번거로웠다. Kimi Code CLI는 단일 바이너리와 튜닝된 TUI로 설치·시작 과정을 단순화하여 별도 Node.js 환경 없이도 즉시 에이전트를 실행하도록 한다. 또한 MCP 기반의 모델 서버 구성과 ACP를 통한 에디터 통합으로 모델 인증·연동과 에디터 내 작업 흐름을 일원화한다.

차별점

• 단일 바이너리 배포로 별도 Node.js 런타임이나 글로벌 패키지 충돌 문제를 회피한다.
• 목적에 맞게 최적화된 TUI를 통해 긴 대화형 에이전트 세션에서 반응성을 유지한다.
• 대화형 MCP 구성으로 JSON 파일을 직접 편집하지 않고도 모델 서버를 추가·인증할 수 있다.
• ACP를 통한 에디터 통합으로 Zed·JetBrains 등에서 별도 로그인 없이 세션을 드라이브할 수 있다.

사용 사례

• 터미널에서 직접 코드 베이스를 분석하고 자동으로 수정 패치를 적용해야 할 때 에디터 전환 없이 작업을 진행할 수 있다.
• 스크린 녹화나 데모 영상을 참고해 재현 가능한 코드 변경이나 색보정(LUT) 변환 같은 미디어 기반 작업을 자동화할 때 유용하다.
• 사내 모델 또는 외부 MCP 서버를 대화형으로 구성하여 여러 모델 엔드포인트를 시험하고 전환해야 할 때 편리하게 활용할 수 있다.

시작하기

설치 방법으로 macOS/Linux는 curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash 명령이나 Homebrew 패키지로 설치하면 된다. 설치 후 새 쉘 세션에서 `kimi`를 실행하고 첫 런에서는 에이전트 내부에서 `/login`을 수행하여 Kimi Code OAuth 또는 Moonshot AI Open Platform API 키로 인증하면 기본 사용 준비가 완료된다. 에디터 통합을 원하면 `kimi acp` 서브커맨드를 에디터 설정에 등록하여 Zed나 JetBrains와 연결하면 된다.

요구사항

• 사용자용 런타임 기준으로 공식 설치 스크립트와 Homebrew 배포는 별도 Node.js 설치를 요구하지 않는다.
• 개발 환경에서는 Node.js ≥ 24.15.0과 pnpm 10.33.0이 필요하며 레포지토리 빌드와 테스트를 위해 pnpm 명령 체인이 사용된다.
• Windows에서는 Git for Windows의 Git Bash를 쉘 환경으로 사용하므로 최초 실행 전 해당 패키지 설치가 필요하며 커스텀 경로일 경우 KIMI_SHELL_PATH를 설정해야 한다.

이미지 분석