Moonshot AI는 Kimi K2.7 코드 모델과 함께 Kimi Code를 출시했습니다. Kimi Code는 저장소를 읽고, 파일을 작성 및 편집하며, 셸 명령어를 실행하고, 병렬 작업을 위해 하위 에이전트를 생성하는 터미널 기본 코딩 에이전트입니다. Claude Code나 Codex를 사용해 보셨다면 익숙하게 느껴질 것입니다. 차이점은 내부 엔진과 가격입니다. Kimi Code는 오픈 가중치 모델로 실행되며, 토큰당 요금 대신 정액 구독 방식으로 청구됩니다.
이 가이드는 깨끗한 머신에서 첫 번째 에이전트 작업을 시작하는 방법부터 실제로 사용하게 될 명령어와 설정을 다룹니다.
Kimi Code란 무엇인가
Kimi Code는 K2.7 코드 모델의 강점인 턴 간의 사고 유지, 교차 추론, 다단계 도구 호출을 활용하도록 구축된 Moonshot 자체 에이전트 프레임워크입니다. 기본적으로 다음을 수행할 수 있습니다.
- 여러 파일에 걸쳐 코드를 작성, 디버그 및 리팩터링
- 대규모 코드베이스 탐색 및 설명
- 셸 명령어 실행 및 파일 처리
- 문서 및 최신 정보 웹 검색
- 병렬로 작업을 실행하기 위한 하위 에이전트 생성
Kimi Code는 터미널, 확장 프로그램을 통한 VS Code, ACP 프로토콜을 통한 JetBrains 또는 Zed에서 실행됩니다. 이 모델은 오픈 가중치이므로, 필요하면 동일한 인텔리전스를 자체 호스팅할 수 있습니다. 모델 세부 정보는 Kimi K2.7 코드 설명서를 참조하십시오.
Kimi Code 설치
설치 프로그램은 먼저 uv (Python 패키지 관리자)를 가져온 다음, 이를 통해 CLI를 설치합니다. 한 줄로 전체 작업이 완료됩니다.
macOS 및 Linux:
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
Windows (PowerShell):
irm https://code.kimi.com/kimi-code/install.ps1 | iex
완료되면, 어떤 프로젝트 디렉토리에서든 에이전트를 시작하십시오:
kimi
첫 실행 시 현재 폴더에서 대화형 세션으로 들어갑니다. Kimi Code는 해당 디렉토리를 프로젝트 루트로 취급하므로, 시작하기 전에 작업하려는 저장소로 cd하여 이동하십시오.
로그인
세션 내에서 하나의 명령으로 인증하십시오:
/login
그러면 Kimi 계정으로 OAuth 흐름이 시작되고 CLI가 Kimi Code 플랫폼에 연결됩니다. 예를 들어, 타사 도구를 사용하기 위해 API 키를 사용하려면 Kimi Code 콘솔에서 생성하십시오. 각 계정은 최대 5개의 키를 허용합니다.
할당량에 대한 간략한 설명: Kimi Code는 구독 플랜으로 실행되며, 월별이 아닌 7일 주기로 제한이 재설정됩니다. 요금제에 따라 5시간당 약 300~1200개의 요청과 최대 30개의 동시 요청으로 제한됩니다. 세션 중에 /usage를 확인하여 현재 상태를 확인하십시오.
첫 번째 작업
에이전트가 로그인되면, 원하는 것을 일반 언어로 설명하기만 하면 됩니다. 좋은 첫 실행은 프로젝트를 학습시키는 것입니다:
/init
/init은 코드베이스를 분석하고 구조, 규칙 및 주요 진입점을 캡처하는 AGENTS.md 파일을 작성합니다. 에이전트는 향후 실행 시 해당 파일을 읽으므로, 매번 저장소를 재탐색하는 대신 컨텍스트를 가지고 각 세션을 시작합니다. 코딩 에이전트를 위한 DESIGN.md를 사용해 보셨다면, 이것은 자동으로 적용되는 동일한 아이디어입니다.
그 후에는 실제 작업을 부여합니다:
Add input validation to the POST /users endpoint and write a test for the empty-email case.
Kimi Code는 변경 사항을 계획하고, 파일을 편집하고, 테스트를 실행한 다음 보고합니다. 기본적으로 파괴적인 작업을 수행하기 전에 묻습니다. 특정 작업을 신뢰하고 더 이상 묻지 않기를 원하면 자동 승인을 토글하십시오:
/yolo
이 명령어는 신중하게 사용하십시오. 새로운 스크래치 작업에는 훌륭하지만, 중요한 저장소에서는 위험할 수 있습니다.
알아두면 유용한 슬래시 명령어
슬래시 명령어로 세션을 제어합니다. 다음은 매일 사용하게 될 명령어들입니다.
| 명령어 | 설명 |
|---|---|
/help |
모든 명령어 나열 |
/login |
Kimi 계정으로 인증 |
/init |
프로젝트 분석 및 AGENTS.md 생성 |
/model |
활성 모델 전환 |
/usage |
현재 주기의 남은 할당량 확인 |
/sessions |
과거 세션 나열 |
/resume |
이전 세션을 컨텍스트와 함께 다시 열기 |
/clear |
현재 컨텍스트 재설정 |
/compact |
컨텍스트 확보를 위해 대화 압축 |
/yolo |
작업 자동 승인 토글 |
/exit |
세션 종료 |
/compact는 과소평가된 명령어입니다. 에이전트가 오래 실행되면 컨텍스트 창이 도구 출력으로 채워집니다. 압축하면 기록이 요약되어 처음부터 다시 시작하거나 창을 넘어서지 않고 계속 진행할 수 있습니다.
기존 에디터 또는 에이전트에 연결
K2.7 코드 모델을 사용하기 위해 현재 설정을 포기할 필요는 없습니다.
VS Code. 마켓플레이스에서 "Kimi Code" 확장 프로그램을 설치하고 동일한 계정으로 로그인하십시오.
JetBrains 및 Zed. CLI의 ACP 프로토콜을 통해 연결하여, 이미 사용하는 에디터 내에서 에이전트가 실행되도록 합니다.
Claude Code, Cline 및 RooCode. 이 모델은 OpenAI 호환 API를 통해 제공됩니다. 도구의 기본 URL을 https://api.moonshot.ai/v1로 지정하고, 모델을 kimi-k2.7-code로 설정한 다음, API 키를 입력하십시오. 이 흐름은 Claude Code 및 Cursor 내에서 Kimi를 실행하기 위해 문서화한 것과 동일하며, 모델 ID만 변경됩니다.
MCP 및 하위 에이전트로 사용자 정의
두 가지 기능 덕분에 Kimi Code는 단순히 실행하는 것보다 구성할 가치가 있습니다.
모델 컨텍스트 프로토콜 (MCP). Kimi Code는 MCP 클라이언트이므로, 외부 도구 서버(데이터베이스 리더, 브라우저, 내부 API, 이슈 트래커)를 연결할 수 있습니다. 에이전트는 작업의 일부로 이러한 도구를 호출합니다. MCP 서버를 구축하거나 테스트하는 경우, 에이전트에 넘기기 전에 도구 계약을 유효성 검사하는 방법은 MCP 서버 테스트 플레이북을 참조하십시오.
하위 에이전트. 명확하게 분할되는 작업의 경우, Kimi Code는 병렬로 실행되고 주 세션으로 보고하는 하위 에이전트를 생성할 수 있습니다. "모든 서비스에서 더 이상 사용되지 않는 호출을 스캔"하거나 "이 여섯 가지 모듈에 대한 테스트를 한 번에 작성"하는 것과 같은 경우를 생각해 보세요. Claude Code 하위 에이전트와 마찬가지로 구성에서 사용자 지정 에이전트를 정의합니다.
구축하기 전에 API 테스트
API를 통해 kimi-for-coding을 자체 도구에 연결하는 경우, 정확히 무엇을 반환하는지 알 수 있도록 먼저 원시 엔드포인트를 테스트하십시오. Apidog는 이를 위한 시각적 작업 공간을 제공합니다.
https://api.moonshot.ai/v1/chat/completions에POST요청을 생성합니다.- Kimi 플랫폼 콘솔의 키를 사용하여
Authorization: Bearer <your-key>헤더를 추가합니다. "model": "kimi-k2.7-code"및messages를 포함하는 OpenAI 스타일 본문을 보냅니다.- 형식화된 응답과 토큰 사용량을 읽은 다음, 해당 호출을 재사용 가능한 테스트로 저장합니다.
여기서 상태 코드를 확인하고, 에이전트가 의존하는 도구 호출 구조의 유효성을 검사하며, Moonshot이 모델을 업데이트할 때마다 검사를 다시 실행할 수 있습니다. 이를 설정하려면 Apidog를 다운로드하십시오.
Kimi Code로 전환할 가치가 있을까요?
솔직한 답변은 무엇을 최적화하느냐에 달려 있습니다. K2.7 코드 모델은 대부분의 코딩 벤치마크에서 GPT-5.5 및 Claude Opus보다 몇 점 뒤처지므로, 가능한 최고의 단일 샷 품질을 원한다면 여전히 폐쇄형 프론티어 모델이 우세합니다. 그러나 Kimi Code는 유능한 에이전트와 오픈 가중치 모델 및 정액 요금제를 결합하여 하루 종일 긴 에이전트 세션을 실행하는 사람들에게는 계산이 달라집니다. 에이전트 환경의 현재 위치에 대한 비교는 Claude Code 대 OpenAI Codex 비교를 참조하십시오.
위험 부담이 적은 방법: 설치하고, 사이드 프로젝트에서 /init을 실행하고, 실제 작업을 할당해 보십시오. 오후 안에 현재 에이전트 옆에 자리할 가치가 있는지 알게 될 것입니다.
자주 묻는 질문
Kimi Code는 어떻게 설치하나요? 한 줄 설치 프로그램(macOS/Linux에서는 curl ... | bash, Windows에서는 irm ... | iex)을 실행한 다음, kimi로 시작하십시오.
어떻게 로그인하나요? 세션 내에서 /login을 실행하여 OAuth를 사용하거나, 타사 도구를 위해 Kimi Code 콘솔에서 API 키를 생성하십시오.
어떤 모델로 실행되나요? Kimi K2.7 코드입니다. Kimi Code 구독에서는 모델 ID가 kimi-for-coding이며, 토큰당 지불 방식의 Moonshot API에서는 kimi-k2.7-code입니다.
VS Code에서 작동하나요? 네, "Kimi Code" 확장 프로그램을 통해 작동합니다. JetBrains와 Zed는 ACP 프로토콜을 통해 연결됩니다.
Claude Code 또는 Cline과 함께 사용할 수 있나요? 네. API는 OpenAI 호환이므로, 도구의 기본 URL을 Kimi 엔드포인트로 지정하고 모델 ID를 설정하십시오.
비용은 얼마인가요? 토큰당 청구가 아닌, 7일마다 할당량이 갱신되는 구독 플랜으로 실행됩니다. /usage를 확인하여 남은 할당량을 확인하십시오.
MCP를 지원하나요? 네. Kimi Code는 MCP 클라이언트이며 사용자 지정 하위 에이전트를 지원합니다.
요약
Kimi Code는 Moonshot의 오픈 가중치 K2.7 코드 모델을 기반으로 구축된 터미널 및 IDE 코딩 에이전트입니다. 한 번의 명령으로 설치하고, /login으로 로그인하고, /init을 실행하여 저장소를 학습시킨 다음, 작업을 할당하십시오. MCP를 지원하고, 하위 에이전트를 생성하며, VS Code, JetBrains, Zed 및 Claude Code와 같은 OpenAI 호환 도구와 연동됩니다. 이론상 최고 점수를 받는 에이전트는 아니지만, 오픈 모델의 정액 요금제는 매일 집중적으로 사용하는 사용자에게 진지한 선택지가 됩니다. 먼저 Apidog에서 API를 테스트한 다음, 실제 작업에 에이전트를 투입하여 자신의 코드에서 판단해 보십시오.