Kimi Code CLI란? 초가성비 AI 코딩 CLI의 사용법 총정리

Claude Opus API보다 약 5배 낮은 비용으로 사용할 수 있는 AI 코딩 CLI가 등장했습니다. 최대 128개의 서브 에이전트가 여러 하위 작업을 병렬로 처리해, 코드 저장소 분석과 리팩토링, 반복 테스트처럼 범위가 넓은 개발 업무를 효율적으로 진행할 수 있습니다. 바로 ‘Kimi Code CLI’입니다.

개발자 친화적 터미널 환경에 K 2.6 모델을 연동해 토큰 사용량이 많은 장시간 작업도 비교적 낮은 비용으로 이어갈 수 있고, Kimi Code는 멤버십 Quota와 종량제 API 방식을 선택할 수 있어, 작업량에 맞춰 AI 에이전트 사용 비용을 관리할 수 있습니다.

이 글에서는 Kimi Code CLI의 특징부터 설치 방법, 로그인 과정, 주요 명령어까지 정리했습니다. 

Kimi Code CLI 핵심 요약

• 터미널에서 실행하는 AI 코딩 에이전트입니다. 프로젝트 파일을 읽고 수정하며, 쉘 명령어와 테스트를 실행할 수 있습니다.
• 복잡한 업무를 여러 단계로 나눠 처리합니다.  /goal을 활용하면 명확한 목표를 설정하고, 작업이 완료될 때까지 분석과 수정, 검증을 반복할 수 있습니다.
• 여러 에이전트가 함께 작업할 수 있습니다.  /swarm 명령어를 입력하면 복잡한 업무를 여러 하위 작업으로 나누고 병렬로 처리할 수 있습니다.
• MCP와 Skills를 연결할 수 있습니다.  외부 도구를 추가하거나, 반복적으로 사용하는 개발 규칙과 업무 절차를 저장해 다시 활용할 수 있습니다.
• 터미널뿐만 아니라 브라우저와 IDE에서도 사용할 수 있습니다. Web UI와 VS Code 확장 프로그램, ACP 기반 IDE 연동을 지원합니다.

Kimi Code CLI란?

Kimi Code CLI는 Moonshot AI가 제공하는 Kimi Code의 주요 기능을 명령어 기반 터미널 환경에서 사용할 수 있도록 구성한 AI CLI 도구입니다. 터미널 환경에서 코드를 직접 수정하고, 빌드와 테스트 명령어를 실행하며, 웹페이지에서 관련 자료를 확인할 수도 있습니다.

단순히 코드를 생성하는 것을 넘어 작업 결과를 살펴보고 다음 단계를 스스로 조정한다는 점이 특징으로, 새로운 기능을 추가하거나 오류를 수정할 때 필요한 파일을 찾고, 수정한 코드를 검증하는 과정까지 하나의 흐름으로 이어갈 수 있습니다.

이전 버전은 Python과 uv를 기반으로 작동해 별도의 개발 환경을 준비하고 관리해야 하는 불편함이 있었으나, 최신 버전부터 TypeScript와 Node.js 기반으로 전환되면서 설치 과정이 단순해지고, 터미널 화면도 장시간 개발 작업에 적합한 구조로 개선되었습니다. 

Kimi Code CLI가 주목받는 이유

1. Claude 대비 약 5배 낮은 API 비용

Kimi K2.6 API를 연결하면 Claude API보다 낮은 비용으로 AI 코딩 에이전트를 활용할 수 있습니다. 

Claude Opus API와 비교하면 입력 비용은 약 5.3배, 출력 비용은 약 6.3배 낮고, Claude Sonnet API와 비교해도 입력과 출력 비용이 약 3~4배 낮습니다.

타 AI 모델 대비 API 비용 부담이 낮아 코드 저장소 전체 분석과 여러 파일에 걸친 리팩토링, 반복 테스트처럼 사용량이 많은 작업에도 AI 에이전트를 적극적으로 활용할 수 있습니다.

2. Quota 기반으로 비용을 예측하기 쉽습니다

Kimi Code는 정해진 구독료 안에서 Quota를 사용하는 방식으로 제공됩니다. 플랜에 따라 사용할 수 있는 양이 구분되어 있어, 개발자는 작업량에 맞춰 비용을 미리 정할 수 있습니다.

구독 시작일을 기준으로 7일마다 초기화되고, 짧은 시간에 요청이 몰리는 것을 방지하기 위한 5시간 단위 제한도 함께 적용되어, 정해진 예산 안에서 AI 코딩 에이전트를 운영할 수 있습니다.

3. 최대 128개 서브 에이전트 지원 

Kimi Code CLI에서는 /swarm 명령어를 활용해 여러 서브 에이전트가 하나의 목표를 나눠 처리하도록 구성, 최대 128개의 서브 에이전트를 사용할 수 있습니다.

하나의 에이전트가 모든 파일을 순서대로 확인하는 대신 여러 에이전트가 병렬로 작업하기 때문에, 규모가 큰 코드 저장소에서도 분석 범위를 넓히고 작업 시간을 줄이는 데 도움이 됩니다.

4. 256K 토큰의 컨텍스트 윈도우 

Kimi Code CLI에 Kimi K2.6 API를 연결하면 최대 256K 토큰의 컨텍스트 윈도우를 활용할 수 있습니다. 컨텍스트 윈도우가 넓으면 코드 저장소를 분석하거나 여러 파일에 걸친 리팩토링과 장시간 디버깅을 진행할 때 앞서 확인한 내용을 더 안정적으로 유지할 수 있습니다.

5. 오픈소스 CLI 기반의 자유로운 확장성 

Kimi Code CLI는 오픈소스로 공개되어 있습니다. 개발자는 GitHub에서 소스 코드를 확인하고, 필요한 경우 프로젝트 환경에 맞춰 기능을 수정하거나 확장할 수 있습니다.

MCP 서버와 Skills, Plugins, Hooks도 연결할 수 있습니다. 외부 서비스와 도구를 추가하거나, 프로젝트별 코드 스타일과 리뷰 기준을 설정하고, 특정 작업 전후에 실행되는 자동화 흐름을 구성할 수 있습니다.

Kimi Code CLI 사용법 

Kimi Code CLI 설치 방법

Kimi Code CLI는 macOS와 Linux, Windows에서 각각 다른 명령어를 사용해 설치합니다.

macOS와 Linux

터미널에 위의 명령어를 입력하면 설치됩니다.

Windows

Windows에서는 PowerShell을 열고 위의 명령어를 입력합니다. 설치가 완료되면 Kimi Code CLI를 처음 실행하기 전에 Git for Windows를 설치해야 합니다. 

Kimi Code CLI는 Git for Windows에 포함된 Git Bash를 셸 환경으로 사용합니다. Git Bash를 기본 경로가 아닌 다른 위치에 설치했다면, KIMI_SHELL_PATH 환경 변수에 bash.exe의 전체 경로를 설정해야 합니다.

npm 설치

Node.js 24.15.0 이상이 설치되어 있다면 npm을 통해 Kimi Code CLI를 설치할 수 있습니다.  

Kimi CLI 사용법

터미널에서 위의 명령어를 입력하면 터미널 기반 인터페이스가 실행됩니다. 

기존 Kimi CLI는 Python과 uv를 기반으로 작동했지만, 최신 Kimi Code CLI는 TypeScript와 Node.js 기반으로 새롭게 설계되었습니다. 이에 따라 설치 과정이 단순해졌으며, 터미널 화면도 장시간 개발 작업에 더 적합한 구조로 개선되었습니다.

처음 실행하면 인증 과정이 필요합니다. 입력창에 /login을 입력해 계정을 로그인 합니다. 로그인 방식은 아래 3가지가 있습니다.

• Kimi Code (OAuth): 브라우저에서 Kimi 계정으로 로그인합니다. 별도의 API Key를 입력하지 않아도 Kimi Code 멤버십의 Quota를 사용할 수 있습니다 
• Kimi Platform (API key · platform.kimi.com): platform.kimi.com에서 발급받은 API Key를 직접 입력합니다. 사용한 토큰만큼 비용이 부과됩니다. 
• Kimi Platform (API key · platform.kimi.ai): platform.kimi.ai에서 발급받은 API Key를 직접 입력합니다. 사용한 토큰만큼 비용이 부과됩니다. 

계정 로그인은 필수가 아니지만 OAuth 로그인 또는 API Key 연결 중 하나는 반드시 필요합니다. 

Kimi Platform API Key 발급 방법 

Kimi Platform은 중국 본토용과 글로벌용으로 구분됩니다. 중국 본토에서는 platform.kimi.com, 한국을 포함한 해외 지역에서는 platform.kimi.ai를 사용합니다.

두 플랫폼의 계정과 API Key는 서로 호환되지 않습니다. 국내에서 Kimi Code CLI에 API Key를 연결하려면 일반적으로 Kimi Platform (API key · platform.kimi.ai) 항목을 선택하면 됩니다.

글로벌 플랫폼에서 API Key를 발급받기 위해 https://platform.kimi.ai/console/api-keys로 접속해 로그인합니다.

API Key 발급을 위해 우측 상단의 Create API Key 버튼을 클릭합니다.

API Key 이름과 연결할 프로젝트를 입력하는 화면이 나타납니다. API Key의 용도를 알아볼 수 있도록 이름을 지정한 뒤, Project 항목에서는 드롭다운 메뉴를 열어 default를 선택합니다.

화면 하단에는 누적 충전 금액이 10달러에 도달하면 더 높은 사용 한도인 Tier 1이 활성화된다는 안내가 표시됩니다. 

API Key 생성과는 별개의 조건이지만, 실제로 API를 호출하려면 잔액을 충전해야 할 수 있으므로 함께 확인하는 것이 좋습니다.

API Key가 생성되면 전체 문자열이 화면에 표시됩니다. 해당 Key는 생성 직후 바로 복사해 안전한 곳에 보관해야 합니다.

이후 목록 화면에서는 보안을 위해 Key의 일부만 표시되며, 전체 문자열을 다시 확인할 수 없습니다. 생성 당시 Key를 저장하지 않았다면 새로운 API Key를 발급받아야 합니다. 더 이상 사용하지 않는 기존 Key는 목록의 Delete 버튼을 눌러 삭제하는 것이 좋습니다.

Kimi Code CLI 로그인하기

/login 명령어를 입력하면 로그인 방식을 선택하는 화면이 나타납니다. 글로벌 플랫폼에서 발급받은 API Key를 연결하려면 가장 아래에 있는 Kimi Platform (API key · platform.kimi.ai) 항목을 선택한 뒤 Enter를 누릅니다.

Kimi 글로벌 플랫폼에서 발급받은 API Key를 입력한 뒤 Enter를 누릅니다. 

인증이 완료되면 사용할 모델을 선택하는 화면이 나타납니다. Kimi K2.6과 Kimi K2.5 중 원하는 모델을 선택한 뒤 Enter를 누릅니다. 

API Key를 입력하고 사용할 모델을 선택하면 화면 상단에 Model: kimi-k2.6이 표시됩니다. 해당 문구가 나타나면 Kimi Code CLI에 모델 설정이 완료된 상태이며, 바로 작업을 시작할 수 있습니다.

 Kimi Code CLI 사용시 자주 사용하는 명령어

Kimi Code CLI 요금제

Kimi Code CLI를 사용하는 방법은 두 가지입니다. Moderato 이상의 유료 플랜을 구독해 Kimi Code Quota를 사용하거나, Kimi Platform API Key를 연결해 사용한 토큰만큼 비용을 지불할 수 있습니다.

• Kimi Code Quota는 구독 시작일을 기준으로 7일마다 갱신되며, 남은 사용량은 다음 주기로 이월되지 않습니다.
• 짧은 시간에 요청이 집중되면 최근 5시간 동안의 사용량을 기준으로 별도의 제한이 적용될 수 있습니다. 동일한 계정으로 로그인한 CLI와 VS Code, Kimi Code Console에서 발급한 API Key는 같은 Quota를 공유합니다.
• 자사 서비스에 Kimi 모델을 직접 연결하려면 멤버십과 별도로 운영되는 Kimi Platform API를 사용해야 합니다. Kimi Platform API는 사용한 토큰을 기준으로 비용이 부과됩니다.

AI 에이전트 활용 능력 향상을 위한 콘텐츠 3가지

옵시디언 CLI 사용법, 개발 노하우를 AI 지식 자산으로 만들기

오픈코드(OpenCode) 사용법, 기존 CLI 기반 AI 코딩 툴과 무엇이 다를까?

안티그래비티 2.0 사용법, 설치부터 권한 설정과 앱 생성까지 총정리