Kimi Code: 터미널과 IDE를 위한 차세대 AI 코딩 Agent

기존의 코드 완성 도구는 입력하는 동안 코드 조각을 제안하지만, 프로젝트 전체에 대한 깊은 이해는 부족합니다. 여러 파일을 리팩터링하거나 복잡한 문제를 디버깅하거나 반복 작업을 자동화할 때, 개발자는 IDE, 터미널, 문서를 오가며 각 단계를 수동으로 조율해야 하는 경우가 많습니다.

AI 코딩 에이전트는 단순한 제안 이상의 역할을 합니다. 전체 저장소를 분석하고, 여러 단계에 걸친 변경을 계획하고, 명령어를 실행하며, 자율적으로 반복 작업을 수행합니다. 한 줄씩 도와주는 대신 복잡한 워크플로를 처리할 수 있는 엔지니어링 파트너처럼 작동합니다.

Kimi Code는 이러한 에이전트 기반 접근 방식을 바탕으로 만들어졌습니다. 터미널에서 실행되고 VS Code와 같은 주요 IDE와 통합되어, 긴 컨텍스트 추론과 고속 실행을 결합해 대규모 다중 파일 리팩터링, 디버깅, 자동화를 지원합니다.

Kimi Code의 주요 기능

Kimi Code는 Kimi K3의 성능을 터미널 우선 설계와 깊은 IDE 통합과 결합합니다. 이러한 에이전트 주도 방식은 단순한 코드 완성을 뛰어넘는 여러 핵심 기능으로 뒷받침됩니다:

에이전트 기반 워크플로

코드만 제안하는 도구와 달리 Kimi Code는 진정한 에이전트로 작동합니다. 코드베이스를 분석하고, 계획을 세우고, 명령어를 실행하고, 결과에 따라 반복 작업을 수행합니다. "모든 API 호출을 async/await를 사용하도록 리팩터링해줘"라고 말하면 관련된 모든 파일을 찾아내고, 변경 사항을 적용하고, 테스트를 실행하고, 문제를 수정하는 과정을 모두 자동으로 처리합니다.

최대 1M 컨텍스트 창

Kimi K3은(는) 최대 100만 토큰의 컨텍스트 창을 제공하므로, Kimi Code는 프로젝트 전체 구조, 의존성, 패턴을 이해할 수 있습니다. 현재 편집 중인 파일만 보는 것이 아니라 모든 것이 어떻게 연결되어 있는지 파악합니다. 이 덕분에 다중 파일 리팩터링, 아키텍처 변경, 대규모 디버깅이 가능해집니다. Kimi K3은(는) 네이티브 시각 이해 기능도 갖추고 있어 스크린샷, 다이어그램, 영상을 코딩 작업의 일부로 추론할 수 있습니다.

Plan 모드와 셸 모드

• 계획 모드(Plan mode): Shift-Tab을 누르거나 /plan을 입력하면 계획 모드로 전환됩니다. Kimi Code가 코드베이스를 분석해 단계별 계획을 제안하고, 승인을 받기 전에는 파일을 건드리지 않습니다. 대규모 변경 작업을 시작할 때 가장 안전한 방법입니다.

• 셸 모드(Shell mode): 입력창에 !를 입력하면 대화를 벗어나지 않고 터미널 명령을 실행할 수 있습니다. 실행 결과는 컨텍스트에 기록되어 이후 대화에서 AI가 이를 참고할 수 있습니다. 실행 시간이 긴 명령은 Ctrl+B를 눌러 백그라운드로 전환한 뒤 /tasks 패널에서 나중에 확인할 수 있습니다.

이러한 유연성 덕분에 신중한 계획, AI 기반 실행, 직접 명령 실행 사이를 자유롭게 오갈 수 있습니다.

사고 강도(thinking effort) 수준

Kimi K3는 low / high / max 사고 강도 수준을 지원하므로 작업마다 적절한 강도를 선택할 수 있습니다. 간단한 질문에는 낮은 강도를, 복잡한 아키텍처 결정이나 까다로운 버그, 대규모 리팩터링에는 최대 강도를 사용하세요. /model 명령으로 언제든 모델을 전환할 수 있습니다.

팁: 모델을 전환하면 기존 프롬프트 캐시가 무효화되므로, Kimi K3를 사용하기 전에 /new로 새 세션을 시작하세요. 이렇게 하면 품질은 더 좋아지고 토큰 소비는 줄어듭니다.

고급 상호작용 기능

• 여러 줄 입력: 코드나 오류 로그를 붙여넣을 때 Shift-Enter 또는 Ctrl-J를 눌러 줄바꿈을 삽입할 수 있습니다

• 경로 자동완성: @를 입력하면 작업 디렉터리 내 파일 및 디렉터리 경로가 자동완성됩니다

• 이미지 및 동영상 붙여넣기: Ctrl-V(Windows에서는 Alt-V)를 눌러 이미지나 동영상 클립을 붙여넣고 AI 분석을 받을 수 있습니다. UI 버그를 재현하거나 디자인을 설명할 때 유용합니다(동영상 입력은 동영상을 지원하는 모델이 필요합니다)

• 승인 시스템: Kimi Code는 파일을 수정하거나 명령을 실행하기 전에 확인을 요청합니다. 필요할 때는 두 가지 자동화 수준을 사용할 수 있습니다. YOLO 모드(kimi --yolo 또는 /yolo)는 도구 실행을 자동으로 승인하지만 질문을 할 수도 있고, Auto 모드(kimi --auto 또는 /auto)는 완전히 자율적으로 동작하며 질문하지 않아 무인 실행에 적합합니다

Standard 및 HighSpeed 등급

Kimi Code는 동일한 모델과 동일한 코딩 능력을 기반으로 두 가지 속도 등급을 제공합니다:

• Standard: 일상적인 작업을 위한 기본 등급

• HighSpeed: Standard보다 약 5~6배 빠른 출력 속도로, 높은 안정성 속에서 최대 초당 100 토큰까지 처리합니다. CLI에서는 /model로 즉시 전환할 수 있고, 서드파티 도구에서는 kimi-for-coding-highspeed 모델 ID를 사용하면 됩니다. HighSpeed를 사용하려면 Allegretto 이상 플랜이 필요합니다

할당량 측면에서, 5시간 롤링 윈도우 동안 최대 30개의 동시 요청과 함께 약 300~1,200건의 요청이 지원되며, 이와 별도로 7일마다 자동으로 갱신되는 주간 할당량도 제공됩니다.

원활한 IDE 통합

Kimi Code CLI는 kimi acp 하위 명령을 통해 Agent Client Protocol(ACP)을 네이티브로 지원하며, 다음과의 통합을 지원합니다:

• VS Code: 완전한 기능을 갖춘 Kimi Code 확장 프로그램 제공

• Zed: 네이티브 ACP 지원

• JetBrains IDE: AI 채팅 플러그인을 통한 ACP 호환

MCP(Model Context Protocol) 지원

Kimi Code는 AI 모델이 외부 도구 및 데이터 소스와 안전하게 상호작용할 수 있도록 하는 개방형 프로토콜인 **Model Context Protocol(MCP)**을 지원합니다. 이를 통해 Kimi Code의 기능은 코드 편집을 넘어 확장됩니다:

• 외부 도구 통합: 데이터베이스, API, 문서 소스, 개발 도구에 연결

• 맞춤형 워크플로: 보안 스캔, 성능 분석, 문서 생성 등 특정 작업을 위한 전용 에이전트를 구축

• 생태계 호환성: 커뮤니티의 기존 MCP 서버를 사용하거나 직접 서버를 만들 수 있습니다

MCP 서버는 mcp.json 파일—사용자 수준(~/.kimi-code/mcp.json) 또는 프로젝트별(.kimi-code/mcp.json)—에서 설정하거나, /mcp-config 명령으로 대화형으로 설정할 수 있습니다. /mcp는 설정된 모든 서버의 연결 상태를 보여줍니다. stdio, HTTP, SSE 전송 방식을 모두 지원하며, MCP 도구는 보안을 위해 다른 Kimi Code 작업과 동일한 승인 절차를 따릅니다.

세션 및 컨텍스트 관리

Kimi Code는 복잡한 다단계 워크플로를 위한 강력한 세션 관리 및 긴 컨텍스트 처리 기능을 제공합니다:

• 세션 유지: 대화 내용은 자동으로 저장됩니다. --continue로 세션을 재개하거나 --session <id>로 여러 프로젝트를 전환할 수 있습니다

• 컨텍스트 압축: 컨텍스트 한도에 가까워지면 /compact를 사용해 AI가 핵심 정보를 유지하면서 대화 기록을 요약하도록 할 수 있습니다. 무엇을 유지할지 지시문을 함께 전달할 수도 있습니다

• 사용량 모니터링: 언제든지 /usage를 실행하면 토큰 사용량, 컨텍스트 소비량, 할당량 정보를 확인할 수 있습니다

• 새로 시작: /new(별칭 /clear)를 사용해 현재 세션 컨텍스트를 초기화합니다

• 분기 및 내보내기: /fork는 전체 기록을 그대로 유지한 채 세션을 분기하며, /export-md는 세션을 Markdown 파일로 저장합니다

• 백그라운드 작업: Ctrl+B를 눌러 장시간 실행되는 명령과 하위 에이전트를 백그라운드로 이동하고, /tasks 패널에서 추적할 수 있습니다

이러한 기능 덕분에 Kimi Code는 여러 파일에 걸쳐 있고 장시간 컨텍스트를 유지해야 하는 장기 개발 작업에 이상적입니다.

자율 목표, 스웜, 플러그인

단일 프���프트보다 오래 걸리는 작업을 위해 Kimi Code는 더 상위 수준의 자동화 기능을 제공합니다:

• 목표 모드: /goal <objective>로 자율 목표를 시작하면 Kimi Code가 완료되거나 의사결정이 필요한 지점에 도달할 때까지 여러 턴에 걸쳐 목표를 수행합니다. /goal next로 후속 작업을 대기열에 추가할 수 있습니다

• 스웜 모드: /swarm <task>는 동일한 목표에 대해 여러 에이전트를 병렬로 실행하며, 실시간 진행 상황 표시와 속도 제한을 고려한 재시도를 제공합니다

• 플러그인 및 Agent Skills: /plugins를 통해 공식 마켓플레이스에서 스킬과 MCP 서버가 번들된 플러그인 패키지를 설치하거나, Markdown 기반 스킬로 나만의 재사용 가능한 워크플로를 Kimi Code에 학습시킬 수 있습니다

• 예약 작업: 자연어로 시간 예약이나 일회성 알림을 설정하면 Kimi Code가 알맞은 시점에 자동으로 실행합니다

기기 보안 및 호환성

Kimi Code는 전문적인 워크플로에 적합한 보안 및 호환성 기능을 갖추고 있습니다:

• 30일 기기 만료: 보안을 위해 30일 넘게 비활성 상태인 기기는 자동으로 연결이 해제됩니다. 이를 통해 사용하지 않는 기기가 무기한 인증된 상태로 남아 있지 않도록 하며, 다시 접근하려면 /login을 다시 실행하면 됩니다

• 즐겨 사용하는 에이전트와 함께 작동: 공식 CLI와 VS Code 확장 프로그램 외에도, Kimi Code API는 OpenAI 호환 및 Anthropic 호환 프로토콜을 모두 지원하며, Claude Code, OpenCode, Codex 등에 대한 공식 설정 가이드도 제공합니다

• 크로스 플랫폼 일관성: macOS, Linux, Windows(번들된 Git Bash 사용) 어디에서든 Kimi Code는 동일한 명령과 기능으로 일관된 경험을 제공합니다

Kimi Code 멤버십 혜택

Kimi Code는 Kimi 멤버십 플랜 내에서 코드 개발 시나리오를 위해 특별히 설계된 프리미엄 멤버십 혜택입니다. 구독하면 API 액세스, 고성능 컴퓨팅 리소스, 포괄적인 IDE 통합 지원을 포함한 완전한 AI 프로그래밍 기능을 이용할 수 있습니다. CLI, VS Code 확장 프로그램, 서드파티 도구에서 발생하는 요청은 모두 동일한 할당량을 공유하며, 이 할당량은 7일마다 자동으로 갱신됩니다.

핵심 혜택

Kimi Code는 어떻게 사용하나요?

1단계: Kimi Code CLI 설치

Kimi Code CLI는 TypeScript로 작성되어 Node.js에서 실행되며, Python 환경이 필요하지 않습니다.

Linux/macOS (권장):

Windows (PowerShell):

Windows에서는 처음 실행하기 전에 Git for Windows를 설치해야 합니다—CLI는 함께 제공되는 Git Bash를 사용합니다.

npm을 통한 대안 설치 (Node.js 22.19.0 이상 필요):

기존의 Python 기반 kimi-cli를 사용 중이신가요? 설치 후 kimi migrate를 실행하면 기존 설정, 세션, MCP 선언을 한 번에 가져올 수 있습니다.

2단계: 인증 및 설정

Kimi CLI 시작:

그런 다음 다음 방법 중 하나로 인증하세요:

옵션 A: OAuth 로그인 (권장)

/login 명령을 실행하고 "Kimi Code (OAuth)"를 선택하세요. Kimi Code는 OAuth 기기 코드 흐름을 사용합니다: 터미널에 표시된 링크를 열고 Kimi 계정으로 로그인한 뒤 사용자 코드를 입력해 인가하면 되며, API 키를 수동으로 관리할 필요가 없습니다.

옵션 B: API 키 설정

대신 /login에서 "Kimi Platform API key"를 선택하세요(또는 /provider로 provider를 구성하세요). 타사 개발 도구와 연동할 때는 Kimi Code 콘솔에서 API 키를 생성하고 관리할 수 있습니다—최대 5개까지 생성 가능하며, 각 키는 생성 시 한 번만 표시됩니다.

3단계: AI로 코딩 시작하기

인증이 완료되면 바로 Kimi Code를 사용할 수 있습니다.

다음은 몇 가지 예시 명령어입니다:

기본 코드 생성:

여러 파일 리팩터링:

디버깅:

4단계: 고급 기능 사용하기

가장 어려운 작업에는 Kimi K3로 전환하세요: /model을 실행해 Kimi K3을 선택한 다음, 작업에 맞는 사고 강도 수준(low / high / max)을 고르세요. 가장 좋은 결과를 얻고 토큰 소모를 줄이려면 모델을 전환하기 전에 /new로 새 세션을 시작하세요.

셸 명령을 바로 실행하세요: 채팅 입력창에서 ! 뒤에 명령어를 입력하면 바로 실행됩니다.

신중한 변경을 위해 Plan 모드를 사용하세요: Shift-Tab을 누르면 Kimi Code가 파일을 수정하기 전에 먼저 조사하고 계획을 제안합니다.

코드, 이미지, 동영상을 붙여넣으세요: 클립보드에서 붙여넣으려면 Ctrl-V(Windows에서는 Alt-V)를 누르고, 여러 줄을 입력하려면 Shift-Enter 또는 Ctrl-J를 사용하세요.

프로젝트 파일을 참조하세요: @ 뒤에 파일��나 디렉터리 이름을 입력하면 자동 완성됩니다.

5단계: IDE와 통합하기

VS Code:

VS Code 마켓플레이스에서 "Kimi Code" 확장을 설치한 다음 Kimi 계정으로 로그인하세요. 로그인을 건너뛰고 기존 API 키 설정을 사용할 수도 있습니다.

패널의 톱니바퀴 아이콘에서 설정 및 추가 옵션에 접근할 수 있습니다.

명령 팔레트를 열고 "Kimi Code"를 입력하면 추가 명령에 접근할 수 있습니다.

Zed: Kimi Code CLI는 kimi acp 서브커맨드를 통해 ACP를 네이티브로 지원합니다. Zed 설정에서 Kimi Code를 외부 에이전트로 추가하세요:

JetBrains IDE: AI 채팅 플러그인을 활성화하고 "Configure ACP agents"에서 Kimi Code를 추가하면 IDE에서 직접 Kimi 세션을 실행할 수 있습니다.

6단계: 세션과 컨텍스트 관리하기

Kimi Code의 세션 관리 기능은 긴 개발 세션 전반에 걸쳐 컨텍스트를 유지하는 데 도움을 줍니다:

세션 보기 및 전환:

이전 세션 재개:

특정 세션으로 전환:

새 세션 시작하기:

한도에 근접했을 때 컨텍스트 압축하기:

언제든지 /usage를 실행해 토큰 사용량, 컨텍스트 소비량, 할당량을 확인할 수 있습니다. 긴 컨텍스트 작업에서 좋은 결과를 얻으려면 /compact를 주기적으로 실행해 주요 정보를 유지하면서 대화 기록을 요약하세요.

7단계: MCP(Model Context Protocol) 구성

MCP 서버를 통해 외부 도구 연동으로 Kimi Code의 기능을 확장할 수 있습니다. 서버는 mcp.json에 선언되며, 사용자 수준에서는 ~/.kimi-code/mcp.json, 단일 프로젝트에서는 .kimi-code/mcp.json을 사용합니다(같은 이름의 항목이 있으면 프로젝트 항목이 사용자 항목보다 우선합니다).

command 필드가 있는 항목은 stdio 서버이고, url 필드가 있는 항목은 HTTP 서버입니다(레거시 SSE 서비스에만 "transport": "sse"를 설정하세요). 클릭으로 작업하고 싶다면 TUI에서 /mcp-config를 실행해 서버를 대화형으로 추가, 편집, 삭제할 수 있고, /mcp로 연결 상태를 확인할 수 있습니다. OAuth가 필요한 서버는 /mcp-config login <server-name>을 실행하세요.

워크플로에서 MCP 도구 사용하기: 구성이 완료되면 Kimi Code는 MCP 도구를 자동으로 호출할 수 있습니다. 예를 들어 데이터베이스 MCP 서버를 사용하는 경우:

MCP 도구는 다른 Kimi Code 작업과 동일한 승인 메커니즘을 따릅니다. YOLO 모드에서는 MCP 작업이 더 빠른 작업 흐름을 위해 자동으로 승인됩니다.

8단계: 대체 인터페이스

브라우저 UI: 그래픽 환경을 위해 웹 기반 인터페이스를 실행하세요. 포그라운드에서 실행되며 브라우저를 자동으로 엽니다. Ctrl+C로 중지할 수 있습니다:

TUI 안에서 /web을 실행하면 현재 세션을 브라우저에서 이어갈 수 있습니다. kimi vis로 세션 시각화 도구를 열어 세션 전체가 펼쳐지는 모습을 한눈에 볼 수도 있습니다.

업그레이드 또는 제거:

npm으로 설치했다면 대신 npm install -g @moonshot-ai/kimi-code@latest로 업그레이드하세요. 제거하려면 kimi 실행 파일을 삭제하거나(스크립트 설치의 경우) npm uninstall -g @moonshot-ai/kimi-code를 실행하세요(npm 설치의 경우).

실제 사용 사례

Kimi Code는 단순한 자동완성을 넘어서는 복잡한 코딩 작업에 뛰어납니다. 다음은 다섯 가지 실용적인 시나리오입니다.

1. 대규모 코드 리팩터링

• 시나리오: 레거시 코드베이스를 다른 프레임워크로 마이그레이션하거나, 수백 개 파일에 걸쳐 코딩 패턴을 업데이트해야 하는 경우입니다.

• 예시 프롬프트:

2. 복잡한 디버깅

• 시나리오: 여러 서비스, 데이터베이스 쿼리, API 호출이 얽혀 있는 프로덕션 버그를 마주했습니다. 기존 디버깅 도구로는 전체 그림이 보이지 않습니다.

• 예시 프롬프트:

3. 자동 테스트 생성

• 시나리오: 테스트 커버리지가 낮은 대규모 코드베이스가 있습니다. 포괄적인 테스트가 필요하지만 직접 작성하고 싶지는 않습니다.

• 예시 프롬프트:

4. 프로젝트 설정 및 구성

• 시나리오: 새 프로젝트를 시작하며 의존성, 구성 파일, CI/CD, 문서를 포함한 전체 개발 환경을 설정해야 합니다.

• 예시 프롬프트:

5. MCP를 통한 외부 도구 연동

• 시나리오: 코드베이스에 포함되지 않은 데이터베이스, API, 특수 서비스 등 외부 도구와 연동해야 하는 경우가 있습니다. **MCP(Model Context Protocol)**를 사용하면 Kimi Code가 이러한 외부 리소스와 안전하게 상호작용할 수 있습니다.

• 예시 프롬프트:

결론

Kimi Code는 세계 최초의 오픈 3T급 모델인 Kimi K3과 진정한 에이전트 기반 워크플로를 결��하여 차세대 AI 코딩 어시스턴트를 구현합니다. 타이핑에만 반응하는 기존 코드 자동완성 도구와 달리, Kimi Code는 능동적으로 계획을 세우고 실행하며 반복 개선을 수행하므로 다중 파일 리팩터링, 디버깅, 자동화 같은 복잡한 작업에 적합합니다.

최대 1M 컨텍스트 윈도우, Standard 및 HighSpeed 속도 티어, 그리고 매끄러운 IDE 연동을 통해 Kimi Code는 개발자의 코딩 방식을 바꿔놓습니다. 레거시 코드를 마이그레이션하든, 프로덕션 이슈를 디버깅하든, 새 프로젝트를 설정하든, Kimi Code는 더 빠르고 효과적으로 작업할 수 있도록 지능적인 지원을 제공합니다.