# Kimi Code: 정의, 공식 웹사이트, Windows와 macOS에 설치하는 방법
> Moonshot AI의 Kimi Code: 데스크톱 앱, CLI, 편집기 플러그인. Windows와 macOS 설치, /login으로 로그인, 2026년 9월 기준 요금제.
Source: https://ailoot.ai/blog/ko/kimi-code-install/
Canonical: https://ailoot.ai/blog/ko/kimi-code-install/
Language: ko
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-161
Revision: sha256-6100ada0e0a462d26f408c99d29d3779ce2c814693ad7a817080c807236f299d
2026년 9월 17일, Moonshot AI는 AI 코딩 에이전트 Kimi Code의 데스크톱 버전을 출시했습니다. 이전에는 터미널과 편집기 플러그인으로만 사용할 수 있었지만, 이제 브라우저와 터미널이 내장된 macOS 및 Windows용 독립 앱으로도 제공됩니다. 명령어와 요금제는 2026년 9월 19일 공식 페이지를 기준으로 확인했습니다.
[Ailoot 문서: API, 키, 설정](https://ailoot.ai/docs/).
## Kimi Code란
핵심 내용
Kimi Code는 Kimi 모델을 만드는 회사인 Moonshot AI의 AI 코딩 에이전트입니다. 코드를 읽고 편집하며, 명령어와 테스트를 실행하고, 온라인에서 정보를 검색하며, 다음 단계를 스스로 계획합니다. 데스크톱 앱, 터미널 작업용 CLI, 편집기 플러그인의 세 가지 형태로 사용할 수 있습니다.
용도 면에서 Claude Code와 직접 비교할 수 있는 제품입니다. 프로젝트 폴더를 열고 자연어로 작업을 설명하면 에이전트가 코드베이스를 살펴보고 수정 사항을 제안한 뒤 실행합니다. 권한을 얼마나 자주 요청할지도 사용자가 선택할 수 있습니다. 실제 사용에서 두 제품이 어떻게 다른지는 [Kimi K3 vs Claude Code](https://ailoot.ai/blog/ko/kimi-k3-vs-claude-code/)에서 다뤘습니다. 이 글에서는 설치와 설정만 설명합니다.
Kimi Code는 Moonshot 모델을 사용합니다. 최대 1 million 토큰의 컨텍스트 창을 제공하는 플래그십 K3와, 초당 최대 260 토큰을 처리하는 고속 모드가 있는 전문 모델 K2.7 Code입니다. CLI 소스 코드는 MIT 라이선스로 공개되어 있으며, GitHub 저장소는 별 7,000개 이상을 받았습니다.
공식 웹사이트, 문서, 소스 코드:
- 제품 웹사이트: `kimi.com/code`
- CLI 문서: `kimi.com/code/docs` 및 `moonshotai.github.io/kimi-code`
- 저장소: `github.com/MoonshotAI/kimi-code`
2026년 9월 11일 Kimi Code의 코딩 모델이 업데이트되었고, 17일에는 데스크톱 버전과 새 주요 CLI 버전 2.0이 동시에 출시되었으며, 18일에는 업데이트 2.0.1이 공개되었습니다. 이전 Python 버전(kimi-cli)을 설치했다면 더 이상 지원되지 않습니다. 명령어 하나로 데이터를 새 CLI에 마이그레이션할 수 있습니다. `kimi migrate`
## Kimi Code 요금
핵심 내용
설치는 무료입니다. Kimi 모델 사용은 구독 또는 API로 결제합니다. 국제 Kimi Code 웹사이트에서는 월 15달러부터 시작하는 Plus 요금제에 포함되며, Kimi Platform API 키를 사용하면 실제로 사용한 토큰만큼 비용을 냅니다. 구독에는 별도 한도가 있습니다. Kimi Code를 주당 5시간 사용할 수 있습니다.
앱과 CLI는 무료로 다운로드할 수 있지만, 무료 Adagio 요금제에는 Kimi Code가 포함되지 않습니다. 확인 당시 구독 페이지 `kimi.com/membership`에 표시된 가격은 다음과 같습니다.
| 요금제 | 월간 결제 | 연간 결제 |
|-------|-----------------------|-------------------|
| Plus | 월 15달러 | 180달러 |
| Pro | 월 31달러 | 372달러 |
| Max | 월 79달러 | 948달러 |
| Ultra | 월 159달러 | 1908달러 |
Kimi Code는 네 가지 유료 요금제에서 모두 이용할 수 있습니다. 2026년 9월 Kimi는 구독 구성을 개편하고 Kimi Code를 별도로 판매하지 않게 되었습니다. 요금제 이름이 다르게 나온 오래된 리뷰는 최신 정보가 아니므로 구매 전에 구독 페이지를 확인하세요.
구독에는 두 가지 한도가 있습니다. 모든 기능(채팅, Deep Research, 웹사이트, Kimi Code)은 실제 사용 토큰 수를 기준으로 한 공용 크레딧 풀을 사용합니다. Kimi Code에는 주당 5시간이라는 별도 한도도 있습니다. 이 한도는 다른 기능에 영향을 주지 않지만, 집중적으로 사용하면 소진될 수 있습니다.
구독 대신 사용한 만큼 토큰 비용을 지불할 수도 있습니다. CLI에 로그인할 때 `platform.kimi.ai`에서 발급한 “Kimi Platform API key”를 선택하세요. 자주 사용하지 않거나 모델을 타사 도구에 연결하려는 경우 편리합니다. 이 옵션의 조건과 한도는 플랫폼 페이지에서 확인하세요.
결제하기 전에 실제로 카드가 작동하는지 확인하거나, 이용할 수 있다면 API 키 옵션을 사용하세요.
## Kimi Code 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`를 실행합니다(Git for Windows를 먼저 설치하세요). 그런 다음 프로젝트 폴더로 이동해 `kimi`를 실행하고 `/login` 명령어로 로그인합니다.
CLI는 Kimi Code의 기본이자 가장 완전한 형태입니다. 터미널에서 Claude Code를 사용해 본 적이 있다면 작업 흐름이 익숙할 것입니다. 그렇지 않다면 [Claude Code 설치 방법](https://ailoot.ai/blog/ko/install-claude-code/) 가이드에서 시작할 수 있습니다. 두 제품의 작업 흐름은 같습니다.
1. ### 명령어 하나로 CLI 설치
macOS 또는 Linux에서는 터미널에서 다음을 실행합니다.
```bash
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```
Windows에서는 PowerShell에서 다음을 실행합니다.
```powershell
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```
설치 프로그램은 최신 릴리스를 다운로드하고 체크섬을 확인한 뒤 `kimi` 명령어를 PATH에 추가합니다. 이 방식에는 Node.js가 필요하지 않습니다.
Windows에는 추가 요구 사항이 하나 있습니다. 처음 실행하기 전에 [Git for Windows](https://gitforwindows.org/)를 설치하세요. Kimi Code는 작업 셸로 Git Bash를 사용합니다. Git Bash가 표준 경로가 아닌 곳에 설치되어 있다면 `KIMI_SHELL_PATH` 환경 변수에 `bash.exe` 경로를 설정하세요.
Node.js 22.19.0 이상이 이미 설치되어 있다면 npm 옵션도 사용할 수 있습니다.
```bash
npm install -g @moonshot-ai/kimi-code
```
2. ### 설치 확인 및 실행
`cd your-project` 명령어에서 `your-project`를 프로젝트 폴더 경로로 바꾸세요.
```bash
kimi --version
cd your-project
kimi
```
대화형 모드 없이 명령어 하나만 실행하려면 `-p` 플래그를 사용하세요.
```bash
kimi -p "Look at the project structure and explain the main directories"
```
이전 세션을 이어가려면 `-c` 플래그를 사용하세요. `kimi -c`를 실행하면 같은 대화로 돌아갑니다.
3. ### 계정에 로그인
CLI에 다음을 입력합니다.
```
/login
```
두 가지 옵션이 표시됩니다. “Kimi Code (OAuth)”를 선택하면 Kimi 계정으로 로그인할 수 있습니다. 어느 기기에서든 링크를 열고 로그인한 다음 코드를 입력하세요. 이 옵션은 구독 한도를 사용합니다. “Kimi Platform API key”는 `platform.kimi.ai`에서 발급한 키이며, 토큰 사용량만큼 결제합니다. 로그아웃하려면 `/logout`을 사용하세요.
4. ### 첫 작업 맡기기
프로젝트 개요를 요청하며 시작하세요. 에이전트에게 주요 디렉터리를 살펴보고 전체 구성을 설명해 달라고 하세요. 그러면 파일을 어떻게 읽는지 확인하고 로그인과 모델 액세스가 정상 작동하는지 살펴볼 수 있습니다.
새 버전이 나오면 `kimi upgrade` 명령어로 업데이트할 수 있습니다.
## 데스크톱 버전 설치 방법
핵심 내용
macOS와 Windows용 Kimi Code 데스크톱 앱은 공식 `kimi.com/code` 페이지에서 다운로드할 수 있습니다. 브라우저와 터미널이 내장되어 있고, 에이전트가 로컬 프로젝트를 볼 수 있습니다.
데스크톱 버전은 2026년 9월 17일 출시되었으며, 터미널만 사용하고 싶지 않은 사람을 위한 버전입니다. Moonshot AI 문서에 따르면 하나의 창에서 에이전트와의 대화, 브라우저, 터미널을 함께 사용할 수 있습니다. 로컬 프로젝트를 열고 작업을 논의한 뒤 창 사이를 전환하지 않고 변경 사항을 제출할 수 있습니다. 도구 호출, 추론, 수정된 파일 등 에이전트의 모든 단계를 볼 수 있으며 민감한 작업에는 확인이 필요합니다. Always Ask, Ask When Needed, Never Ask의 세 가지 권한 모드로 에이전트가 작업 전에 얼마나 자주 물어볼지 설정할 수 있습니다. 처음 사용한다면 첫 번째나 두 번째 모드가 더 적절합니다.
작업 모드는 두 가지입니다. Plan은 먼저 계획을 만들며, 실행 전에 확인하고 조정할 수 있습니다. Goal은 에이전트가 목표를 향해 스스로 작업하게 합니다. 긴 작업을 백그라운드로 보내거나 일시 중지 또는 중단할 수 있습니다. 내장 브라우저는 오른쪽 패널에 있으며 에이전트에 페이지 맥락을 제공합니다. 페이지 요소를 선택하고, 선택한 텍스트나 스크린샷의 영역에 댓글을 달아 무엇을 수정해야 하는지 정확히 지정할 수 있습니다.
설치 프로그램은 공식 웹사이트에서 이용할 수 있습니다. macOS용은 Apple Silicon 및 Intel 빌드가 있고, Windows용은 x64 설치 프로그램이 있습니다. `kimi.com/code`에서 적합한 빌드를 다운로드해 설치한 다음 로컬 프로젝트 폴더를 열고 같은 Kimi 계정으로 로그인하세요. CLI와 한도 및 결제 방식이 공유되므로 구독과 크레딧 풀이 동일합니다.
## Kimi Code를 편집기에 연결하는 방법
핵심 내용
VS Code에서는 마켓플레이스에서 “Kimi Code” 플러그인을 찾아 설치하세요. Zed와 JetBrains에서는 CLI가 ACP 프로토콜을 통해 작동합니다. 편집기가 `kimi acp` 명령어를 실행하며 별도로 로그인할 필요가 없습니다.
VS Code 확장 프로그램을 설치하는 가장 쉬운 방법은 공식 마켓플레이스에서 “Kimi Code”를 받는 것입니다. 에이전트가 사이드바에 표시되어 코드를 완성하고 파일을 편집하며 온라인 검색을 할 수 있습니다. Kimi 다운로드 페이지에는 Cursor, Web, Zed, JetBrains, Paseo도 나와 있습니다.
Agent Client Protocol을 지원하는 편집기는 CLI를 통해 연결됩니다. Zed에서는 `~/.config/zed/settings.json`에 다음을 추가하세요.
```json
{
"agent_servers": {
"Kimi Code CLI": {
"type": "custom",
"command": "kimi",
"args": ["acp"],
"env": {}
}
}
}
```
이제 Zed의 Agent 패널에서 새 대화를 시작하면 Kimi Code를 통해 실행됩니다. CLI에서 한 번만 계정에 로그인하면 됩니다.
## 에이전트가 기본적으로 할 수 있는 일
표준적인 “읽기, 편집, 테스트 실행” 외에도 CLI에는 몇 가지 기능이 있습니다.
- 비디오 입력: 화면 녹화나 데모 영상을 채팅에 끌어다 놓으면 에이전트가 프레임별로 분석합니다. 설명하는 것보다 보여 주는 편이 쉬운 버그에 유용합니다.
- 수동 JSON 없이 MCP 사용: `/mcp-config`를 사용해 대화 중에 Model Context Protocol 서버를 추가하고 설정할 수 있습니다. [Claude Code용 MCP 서버](https://ailoot.ai/blog/ko/mcp-servers-claude-code/) 글에서 MCP가 무엇이고 왜 사용하는지 다뤘습니다. 프로토콜은 동일합니다.
- 하위 에이전트: 내장된 `coder`, `explore`, `plan`은 격리된 컨텍스트에서 작업을 수행하므로 작업 세부 정보가 주 대화에 포함되지 않습니다.
- 수명 주기 훅: 워크플로의 주요 단계에서 위험한 작업을 확인하고 알림과 감사를 수행하는 사용자 지정 명령어입니다.
- 스킬과 플러그인: 마켓플레이스나 GitHub의 모든 저장소에서 제공하는 패키지를 사용할 수 있습니다.
## 문제가 생겼을 때 확인할 사항
- `kimi --version`에 응답이 없습니다. 새 터미널 창을 여세요. 재시작하면 PATH가 반영됩니다.
- Windows에서 명령어 실행 중 에이전트가 오류와 함께 종료됩니다. Git for Windows가 설치되어 있는지 확인하고, 표준 경로가 아닌 곳에 설치했다면 `KIMI_SHELL_PATH`가 설정되어 있는지 확인하세요.
- 로그인에 실패하거나 작업이 실행되지 않습니다. `/login`을 확인하세요. OAuth는 활성 유료 구독에서만 작동하며, API 키는 플랫폼 잔액이 양수일 때 사용할 수 있습니다.
- 모든 것이 정상 작동했는데 에이전트가 작업을 멈췄습니다. 주당 5시간의 Kimi Code 한도나 공용 크레딧 풀이 소진되었을 수 있습니다. 남은 잔액은 Kimi 웹사이트의 구독 섹션에 표시됩니다.
- 이전 Python CLI와 새 CLI가 충돌합니다. 이전 버전을 제거하고 공식 설치 명령어로 다시 설치하세요.
## 다음에 할 일
앱, CLI, 플러그인 중 하나를 선택해 프로젝트의 실제 작업을 시켜 보세요. 에이전트에게 코드베이스를 살펴보고 작은 수정을 하게 하면 작업 방식이 자신에게 맞는지 알 수 있습니다. 필자는 실제 작업에 Kimi K3를 써 본 뒤 결국 Claude Code로 돌아갔습니다. [잘되지 않았던 점은 여기에서 설명했습니다](https://ailoot.ai/blog/ko/kimi-k3-hands-on-review/). 작업별 비교는 [Kimi K3 vs Claude Code](https://ailoot.ai/blog/ko/kimi-k3-vs-claude-code/)에서 확인할 수 있으며, 무료 옵션 중에서는 [Claude Code의 대안으로서 Qwen Code를 검토한 글](https://ailoot.ai/blog/ko/qwen-code-token-plan-setup/)을 살펴볼 만합니다.
### 출처
- [Kimi Code - 공식 제품 페이지](https://www.kimi.com/code/en)
- [Kimi Code 문서: 개요](https://www.kimi.com/code/docs/en/)
- [시작하기: CLI 설치](https://www.kimi.com/code/docs/en/kimi-code-cli/guides/getting-started.html)
- [GitHub의 MoonshotAI/kimi-code 저장소](https://github.com/MoonshotAI/kimi-code)
- [npm의 @moonshot-ai/kimi-code 패키지](https://www.npmjs.com/package/@moonshot-ai/kimi-code)
- [Kimi 요금제 및 구독](https://www.kimi.com/membership/pricing)
- [도움말 센터의 Kimi 요금제 세부 정보와 Kimi Code 한도](https://www.kimi.com/en/help/membership/membership-overview)
- [Kimi 앱 다운로드](https://www.kimi.com/en/products/download)
- [Kimi API Platform 문서: 토큰별 요금](https://platform.kimi.ai/docs/pricing)
- [새 소식: Kimi Code Desktop 및 CLI 2.0 출시](https://www.kimi.com/code/docs/en/kimi-code/whats-new.html)
- [Kimi Code Desktop: 빠른 시작](https://www.kimi.com/code/docs/en/kimi-code-desktop/getting-started.html)
Ailoot를 통해 신경망 서비스에 액세스해야 한다면 [Ailoot](https://ailoot.ai/)를 확인해 보세요.
## Kimi Code: 정의, 공식 웹사이트, Windows와 macOS에 설치하는 방법: 자주 묻는 질문
### CLI는 설치됐는데 kimi 명령이 없으면 무엇을 확인하나요?
PATH를 다시 읽도록 새 터미널을 열고 `kimi --version`을 확인하세요. Windows에서는 Git for Windows 설치 여부를 확인하세요. Git Bash가 기본 위치에 없다면 설정된 `KIMI_SHELL_PATH`를 점검하세요.
### Kimi Code를 내려받으면 모델도 무료로 쓸 수 있나요?
아닙니다. 앱과 CLI 설치는 무료지만 모델 사용에는 이용 가능한 유료 구독이나 잔액이 있는 Kimi Platform API 키가 필요합니다. 멈춘 작업을 진단하기 전에 `/login`에서 선택한 인증 경로와 관련 한도를 확인하세요.
## Ailoot · 회사와 그 프로젝트 포트폴리오
Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.
회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.
Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.