Claude Code·OpenCode 말고 이것도 있다 — Kimi Code CLI 완전분석

AI 코딩 에이전트 시장에서 Claude Code와 OpenCode, Cursor가 대부분의 주목을 받는 동안, Moonshot AI가 꽤 조용하게 경쟁력 있는 선택지를 밀어붙이고 있었습니다. Kimi Code CLI는 2026년 6월 Moonshot AI가 공개한 오픈소스 터미널 코딩 에이전트로, TypeScript 기반이고 MIT 라이선스입니다. 기반 모델인 Kimi K2.6은 1조 파라미터 MoE 구조에 SWE-bench Pro 58.6%를 기록했고, 최신 K2.7 Code까지 업데이트됐습니다. Claude Code와 비교해 토큰 가격이 수 배 저렴한데 에이전트 병렬 처리 구조를 갖추고 있다는 점에서 실무 도입을 검토할 이유가 있습니다.

Kimi CLI에서 Kimi Code CLI로

Kimi Code CLI를 이해하려면 이전 버전인 Kimi CLI부터 짚어야 합니다. Python으로 작성된 Kimi CLI는 Moonshot AI의 첫 번째 터미널 에이전트였습니다. 기능적으로는 코드 읽기·편집, 셸 명령 실행, 파일 검색, 웹 페이지 조회를 지원했고, Agent Swarm으로 최대 100개 서브에이전트를 병렬 실행하는 구조가 특징이었습니다.

Kimi Code CLI는 그 후속작으로, TypeScript로 완전히 새로 작성됐습니다. GitHub 저장소는 MoonshotAI/kimi-code이고, 기존 kimi-cli 저장소는 단계적으로 종료됩니다. Kimi Code CLI를 설치하면 기존 kimi-cli의 설정과 세션이 자동으로 마이그레이션됩니다. 현재 기반 모델은 K2.6이고, 플랫폼에서는 K2.7 Code API도 제공 중입니다.

기반 모델: Kimi K2.6

Kimi Code CLI의 기본 모델은 Moonshot AI가 kimi-for-coding 프로파일로 튜닝한 Kimi K2.6입니다. 2026년 4월 20일 오픈웨이트로 공개됐고, 총 1조 파라미터 MoE 구조에서 토큰당 약 320억 파라미터가 활성화됩니다. 컨텍스트 윈도우는 256K 토큰이고, SWE-bench Pro 기준 약 58.6%를 기록했습니다.

Claude Opus 4.8의 SWE-bench Pro 대비 낮은 수치이지만, API 가격에서 차이가 납니다. Kimi K2.6 기준 입력 토큰 100만 개당 약 $0.60~$0.95, 출력 100만 개당 $2.50~$4.00 수준입니다. Claude Opus 4.8($6.25 입력)과 비교하면 입력 기준 6~10배 저렴합니다. 반복 실행이 많은 에이전트 파이프라인에서 이 차이는 누적됩니다. 최신 K2.7 Code는 256K 컨텍스트와 Tool Calling을 지원하며 platform.moonshot.ai에서 API를 제공합니다.

설치

Node.js 없이 공식 스크립트로 설치하는 방법이 가장 빠릅니다.

# 공식 스크립트로 설치 (Node.js 불필요)
curl -fsSL https://kimi.moonshot.cn/install/cli | bash

# npm으로 설치
npm install -g kimi-code

Windows에서는 Git Bash가 필요합니다. Git for Windows를 먼저 설치한 뒤 진행하고, Git Bash가 비표준 경로에 있다면 KIMI_SHELL_PATH 환경변수로 bash.exe 절대경로를 지정합니다.

설치 후 첫 실행 시 /login 명령으로 인증합니다. Kimi Code OAuth(브라우저 로그인)와 Moonshot AI Open Platform API 키 두 가지 방식을 지원합니다.

kimi-code
# 에이전트 실행 후
/login

로그인이 완료되면 바로 프로젝트 루트에서 실행할 수 있습니다. 첫 태스크로 "Take a look at this project and explain its main directories"를 입력하면 코드베이스 전체를 훑고 구조를 설명해줍니다.

실전 1: 기본 에이전트 워크플로

Kimi Code CLI는 에이전트 모드와 셸 모드를 Ctrl-X로 전환합니다. 에이전트 모드에서는 입력을 AI가 처리하고 계획을 세워 실행하고, 셸 모드에서는 일반 셸 명령을 바로 실행합니다. 두 모드를 하나의 세션에서 오가며 쓸 수 있습니다.

에이전트에게 멀티 파일 리팩터링을 맡기는 기본 흐름입니다. 파일을 수정하거나 셸 명령을 실행하기 전에 에이전트가 확인을 요청하는데, 이 승인 흐름은 기본값으로 켜져 있습니다.

# 프로젝트 루트에서 실행
cd my-nextjs-project
kimi-code

# 에이전트 모드에서 태스크 입력
> Refactor the auth module to use the new JWT library.
> Update all tests accordingly.

에이전트가 계획을 먼저 보여주고 승인을 받은 뒤 실행합니다. 자동 승인이 필요한 환경이라면 --yolo 플래그를 붙이면 되지만, 프로덕션 코드베이스에서는 권장하지 않습니다.

복잡한 태스크에서는 Thinking Mode를 활용할 수 있습니다. Tab을 누른 뒤 메시지를 보내거나, --thinking 플래그로 시작하면 응답 전에 더 긴 추론 과정을 거칩니다.

kimi-code --thinking
> Design the database schema for a multi-tenant SaaS application with role-based access.

실전 2: 서브에이전트와 병렬 실행

Kimi Code CLI의 핵심 차별점은 내장 서브에이전트 구조입니다. coder, explore, plan 세 가지 서브에이전트가 격리된 컨텍스트에서 병렬로 실행됩니다. Kimi K2.6 기준 최대 300개 서브에이전트를 동시에 띄울 수 있는 구조입니다.

대형 마이그레이션이나 전체 테스트 스위트 실행처럼 독립적인 작업이 많을 때 효과가 큽니다. 아래는 여러 모듈을 병렬로 마이그레이션하는 방식입니다.

> Migrate all API routes from Express to Fastify.
> Run in parallel: auth routes, user routes, payment routes, and admin routes.
> Each subagent should update tests for its own module.

에이전트가 자동으로 작업을 분할하고 서브에이전트를 생성해 병렬 실행합니다. 동일한 작업을 단일 에이전트로 순차 처리할 때보다 실행 시간이 크게 줄어듭니다. Kimi K2.5 기준으로 병렬 처리가 순차 처리 대비 4.5배 빠르다는 수치가 공개되어 있습니다.

실전 3: 프로젝트 룰 설정과 MCP 연동

프로젝트별 코딩 컨벤션을 에이전트에게 주입하려면 .kimi/rules/ 디렉터리에 마크다운 파일을 추가합니다. 에이전트가 세션 시작 시 이 룰을 로드해서 코드 생성과 리뷰에 일관되게 적용합니다.

# .kimi/rules/style.md
- TypeScript strict mode 사용
- 함수형 컴포넌트만 사용
- export 함수에는 JSDoc 필수
- 스타일은 Tailwind CSS로만 처리
- 테스트는 Vitest 사용, jest 금지

MCP 서버 연동은 JSON 설정 파일을 직접 편집하지 않고 /mcp-config 명령으로 대화형으로 처리합니다. Claude Code나 OpenCode에서 MCP 설정이 JSON 직접 편집인 것과 다른 부분입니다.

# 에이전트 세션 내에서
/mcp-config

# 프롬프트에 따라 MCP 서버 추가
> Add a PostgreSQL MCP server at postgresql://localhost:5432/mydb

외부 프로바이더 연동도 지원합니다. Kimi 모델 대신 OpenRouter를 통해 Claude나 GPT 계열을 백엔드로 쓰고 싶다면 환경변수로 전환할 수 있습니다.

export OPENROUTER_API_KEY="your-key"
kimi-code --provider openrouter --model anthropic/claude-opus-4.8

Claude Code·OpenCode와 비교

세 에이전트의 차이를 정리하면 이렇습니다. Claude Code는 Anthropic 모델 최적화와 완성도 높은 에이전트 경험이 강점이지만 Anthropic 모델 전용이고 구독 비용이 높습니다. OpenCode는 75개 이상 프로바이더를 지원하는 완전한 모델 중립성과 LSP 통합이 강점이고 MIT 라이선스이지만, Claude 모델은 구독 없이 API 키로만 연동됩니다. Kimi Code CLI는 저렴한 Kimi 모델과 내장 서브에이전트 병렬 구조가 강점이고 다른 프로바이더 전환도 가능하지만, 256K 컨텍스트 윈도우가 경쟁 대비 작은 편이고 Claude Code 대비 코드 품질 차이가 보고됩니다.

Terminal-Bench 2.1 기준으로 Codex CLI + GPT-5.5가 83.4%, Claude Code + Opus 4.8이 78.9%인 것과 비교하면 Kimi K2.6 기반 Kimi Code CLI는 수치가 낮습니다. 단순 정의된 태스크에서는 격차가 좁혀지고, 긴 호라이즌의 모호한 태스크에서는 클로즈드 소스 모델이 앞섭니다. 비용 민감한 파이프라인에서 반복 태스크를 돌리거나, 병렬 서브에이전트가 실질적으로 필요한 배치 작업이라면 Kimi Code CLI가 현실적인 선택지가 됩니다.

결론

Kimi Code CLI는 Claude Code의 정면 대체재라기보다 특정 조건에서 유리한 선택지입니다. 토큰 비용이 6~10배 낮고 내장 병렬 서브에이전트 구조를 갖추고 있어서, 반복 실행이 많은 배치 파이프라인이나 여러 모듈을 동시에 처리하는 대규모 마이그레이션 작업에서 비용과 속도 면에서 경쟁력이 있습니다. MIT 라이선스 오픈소스이고 외부 프로바이더 전환도 지원해서 벤더 종속 위험도 낮습니다. 다만 256K 컨텍스트 윈도우와 벤치마크 수치에서 Claude Code 대비 한계가 명확하기 때문에, 복잡한 장기 에이전트 작업보다는 범위가 잘 정의된 반복 태스크에 먼저 적용하고 결과를 검증하는 접근이 현실적입니다.