-->

터미널에서 코딩 에이전트를 쓰는 개발자, 특히 코드를 외부로 내보낼 수 없는 조직에서 일하는 분들을 위한 글입니다. 결론부터 말하면 Kimi Code CLI의 진짜 무기는 세간에 도는 “클로드 코드에 없는 기능”이 아니라, 개방 표준 ACP 네이티브 지원과 온프렘 서빙까지 열어 둔 모델 개방성입니다.

Kimi Code CLI는 문샷AI가 MIT 라이선스로 공개한 오픈소스 터미널 코딩 에이전트입니다. 클로드 코드, 제미나이 CLI, 코덱스 CLI와 같은 계열이며 공식 저장소는 MoonshotAI/kimi-code입니다. 이전 프로젝트 MoonshotAI/kimi-cli에서 진화했고 기존 세션과 설정이 그대로 이어집니다.

이름에 K3가 붙지 않는다는 점부터 짚고 갑니다. 이 도구는 특정 모델에 종속되지 않습니다. 기본값으로 코딩 특화 모델 Kimi K2.7 Code를 붙여 쓰지만 설정에서 K3를 포함한 다른 모델로 자유롭게 전환합니다. K3는 문샷이 2026년 7월 16일 공개한 2조8000억 매개변수급 오픈 MoE 모델로, Kimi Delta Attention과 최대 100만 토큰 컨텍스트를 내세웁니다. CLI가 붙일 수 있는 여러 모델 중 하나일 뿐입니다.

전체 구조를 먼저 그려 두면 나머지가 잘 붙습니다. 핵심은 이 CLI가 한쪽으로는 MCP 클라이언트가 되어 도구와 데이터에 연결되고, 다른 한쪽으로는 ACP 서버가 되어 에디터에 연결되는 이중 역할입니다.

flowchart TB
    subgraph EDITOR["개발자 에디터 (ACP 클라이언트)"]
        ZED["Zed"]
        JB["JetBrains 계열"]
        VSC["VS Code / Neovim"]
    end
    ACP["Agent Client Protocol<br/>JSON-RPC over stdio"]
    subgraph CLI["Kimi Code CLI (에이전트 코어)"]
        MAIN["메인 에이전트<br/>대화 히스토리 유지"]
        SUB["서브에이전트<br/>coder · explore · plan<br/>각자 격리 컨텍스트"]
    end
    MODEL["모델 계층<br/>Kimi K2.7 Code / K3<br/>또는 OpenAI 호환 엔드포인트"]
    subgraph MCP["MCP 서버 (도구 · 데이터)"]
        T1["Context7"]
        T2["Chrome DevTools"]
        T3["사내 커넥터"]
    end

    EDITOR --> ACP
    ACP -->|kimi acp| MAIN
    MAIN --> SUB
    MAIN -->|추론 요청| MODEL
    SUB -->|추론 요청| MODEL
    MAIN -->|도구 호출| MCP

서브에이전트와 MCP, 편하지만 새롭진 않다

내장 서브에이전트는 세 종류입니다. coder는 파일을 읽고 쓰고 명령을 실행하는 범용 엔지니어링 담당, explore는 읽기 전용 탐색 담당, plan은 셸 없이 구현 계획만 내놓는 담당입니다. 이름보다 중요한 것은 각 서브에이전트가 완전히 독립된 컨텍스트 윈도우를 가진다는 점입니다. 메인의 대화 히스토리는 서브에이전트에 노출되지 않고, 서브에이전트의 중간 추론과 도구 호출 로그도 메인에 섞이지 않으며 최종 결론만 반환됩니다. 긴 세션에서도 메인 컨텍스트가 로그로 부풀지 않고 얇게 유지되는 이유입니다. 백그라운드 실행과 병렬 실행까지 지원해 여러 탐색을 동시에 돌릴 수 있습니다. 자세한 내용은 공식 문서 Agents and Sub-Agents에 있습니다.

MCP 연동은 두 경로로 관리합니다. 하나는 kimi mcp add 같은 CLI 서브커맨드이고, 다른 하나는 TUI 안에서 쓰는 대화형 슬래시 명령 /mcp-config입니다. 후자 덕분에 JSON 설정 파일을 손으로 편집하지 않고도 서버를 추가하고 인증할 수 있습니다.

# HTTP 트랜스포트 (OAuth 옵션 지원)
kimi mcp add --transport http context7 https://mcp.context7.com/mcp

# stdio 트랜스포트로 로컬 프로세스 연결
kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest

여기까지가 널리 홍보되는 부분인데, 냉정하게 보면 서브에이전트와 격리 컨텍스트, MCP 편의성, 이미지 붙여넣기는 모두 클로드 코드도 이미 제공합니다. 차별점이라 부르기 어렵습니다. 관련 문서는 MCP 설정을 참고하시기 바랍니다.

Agent Client Protocol, 여기가 진짜다

Agent Client Protocol(ACP)은 Zed 에디터 팀이 만든 개방 표준으로, Apache 라이선스이며 JSON-RPC 2.0을 stdio 위에서 주고받습니다. 에디터가 에이전트를 자식 프로세스로 띄우고 표준 입출력으로 통신하는 방식이라, 전송 메커니즘은 언어 서버 프로토콜(LSP)과 동일합니다.

LSP 비유가 이해를 크게 돕습니다. LSP 이전에는 에디터마다 언어마다 별도 통합을 만들어야 했습니다. LSP는 이 M 곱하기 N 문제를 M 더하기 N으로 바꿨습니다. 에디터 하나가 표준만 구현하면 누가 만든 언어 서버든 그 덕을 봅니다. ACP는 정확히 같은 일을 에이전트에 합니다. 에디터가 ACP를 구현하면 누가 만든 에이전트든 표준 방식으로 꽂힙니다. 이 개념은 Zed의 ACP 소개와 마크 누리의 해설 글에서 확인할 수 있습니다.

MCP와 방향이 반대라는 점이 핵심입니다. MCP는 에이전트에서 도구로 향하고 이때 에이전트가 클라이언트입니다. ACP는 에디터에서 에이전트로 향하고 이때 에이전트가 서버, 에디터가 클라이언트입니다. 같은 에이전트가 한쪽으로는 MCP 클라이언트, 다른 쪽으로는 ACP 서버를 동시에 맡습니다. Kimi Code CLI는 kimi acp 서브커맨드로 이 프로토콜을 별도 설치 없이 네이티브로 지원합니다. Zed는 네이티브로, JetBrains는 플러그인으로 연결되어, 개발자는 익숙한 에디터를 떠나지 않고 Kimi 세션을 몰 수 있습니다.

입력 방식에도 오해가 하나 있습니다. 문샷이 정면에 내세우는 것은 정적 스크린샷이 아니라 화면 녹화 영상 입력입니다. 데모 클립을 채팅에 떨어뜨리면 에이전트가 말로 설명하기 어려운 동작을 직접 보고 이해합니다. 기본 모델 K2.7 Code가 비전 인코더 MoonViT를 갖춘 네이티브 멀티모달이라 텍스트, 이미지, 영상을 모두 받습니다. 물론 이미지 붙여넣기도 되지만 진짜 홍보 포인트는 영상입니다.

설치와 모델 개방성

설치는 간결합니다. 아래는 공식 시작 가이드 기준입니다.

# 1) 설치 스크립트 실행 (uv를 함께 설치)
curl -LsSf https://code.kimi.com/install.sh | bash

# 2) 프로젝트 디렉터리에서 실행
kimi

# 3) 인증 설정
/login

macOS는 brew install kimi-code, 윈도우는 파워셸 스크립트도 제공합니다. 소스 개발에는 Node 24.15 이상과 pnpm이 필요합니다. 더 중요한 것은 프로바이더 개방성입니다. ~/.kimi-code/config.toml에서 OpenAI 호환 엔드포인트, Anthropic API 키, 구글 GenAI나 Vertex AI까지 다중 프로바이더로 등록할 수 있어 특정 모델에 락인되지 않습니다. 문서는 Providers and models에 있습니다.

클로드 코드에는 없는 기능인가

가장 널리 퍼진 “클로드 코드에 없는 기능”이라는 프레이밍은 대부분 과장입니다. 진짜 차이는 두 곳뿐입니다. 첫째, ACP를 CLI에 1차 기능으로 내장한 점입니다. 클로드 코드는 Zed가 만든 별도 어댑터를 거쳐 베타로 연결되니, 전자는 켜면 바로 되고 후자는 브릿지를 하나 더 얹어야 합니다(Zed의 베타 글 참고). 둘째, 모델 개방성입니다. Kimi는 오픈웨이트 K 시리즈에 멀티 프로바이더 전환까지 열려 있어 온프렘 서빙이 가능하지만, 클로드 코드는 CLI가 열려 있어도 모델이 API 전용입니다.

이 개방성은 셀프호스팅 관점에서 의미가 큽니다. 오픈웨이트 K 시리즈를 사내 GPU 클러스터에 올리고 CLI를 내부 엔드포인트로 라우팅하면, 외부 API 의존이나 데이터 반출 없이 사내 코딩 에이전트를 구축할 수 있습니다. 코드가 밖으로 나가면 안 되는 금융이나 공공 영역의 온프렘 보안 요건과 정합합니다. 다만 개방성이 곧 손쉬운 셀프호스팅을 뜻하지는 않습니다. 2조8000억 매개변수급 모델을 실제로 서빙하려면 상당한 GPU 자원이 필요하고, 작은 팀에는 API 경로가 여전히 현실적입니다. 도구 생태계의 성숙도와 안정성도 클로드 코드나 코덱스 CLI가 앞설 수 있습니다. 오픈소스라는 사실이 곧 프로덕션 준비 완료는 아닙니다.

그럼에도 개방 표준 위에서 에이전트와 에디터가 느슨하게 결합되는 방향은 분명한 흐름입니다. 특정 벤더 CLI에 종속되지 않고 모델과 에디터를 각각 갈아 끼울 수 있는 세계가 개발자에게 더 유리하며, Kimi Code CLI는 그 세계를 앞당기는 조각 중 하나입니다.

출처

참고