중요

Kimi CLI는 Kimi Code CLI로 진화하고 있습니다. 이는 동일 팀의 차세대 터미널 AI 에이전트입니다. Kimi Code CLI를 설치하면 구성 및 세션이 자동으로 마이그레이션됩니다. 이 프로젝트는 점차 종료될 예정이며, 문서는 계속 이용 가능합니다.

Kimi CLI는 터미널에서 실행되는 AI 에이전트로, 소프트웨어 개발 작업과 터미널 작업을 돕습니다. 코드를 읽고 편집하고, 쉘 명령을 실행하며, 웹 페이지를 검색하고 가져오고, 실행 중에 행동을 자율적으로 계획하고 조정할 수 있습니다.

설치 및 사용 시작 방법은 'Getting Started'를 참조하세요.

Kimi CLI는 단순히 코딩 에이전트일 뿐만 아니라 쉘(shell)입니다. Ctrl-X를 눌러 쉘 명령 모드로 전환할 수 있습니다. 이 모드에서는 Kimi CLI를 벗어나지 않고도 쉘 명령을 직접 실행할 수 있습니다.

참고

cd와 같은 내장 쉘 명령어는 아직 지원되지 않습니다.

Kimi CLI는 Kimi Code VS Code Extension을 통해 Visual Studio Code와 통합될 수 있습니다.

Kimi CLI는 Agent Client Protocol(ACP)을 기본적으로 지원합니다. 이를 ACP 호환 에디터나 IDE와 함께 사용할 수 있습니다.

ACP 클라이언트와 Kimi CLI를 사용하려면, 터미널에서 Kimi CLI를 실행하고 /login을 보내 로그인을 완료해야 합니다. 그런 다음, 명령 kimi acp을 사용하여 Kimi CLI를 ACP 에이전트 서버로 시작하도록 ACP 클라이언트를 구성할 수 있습니다.

예를 들어, Zed나 JetBrains와 함께 Kimi CLI를 사용하려면, 다음 구성을 ~/.config/zed/settings.json 또는 ~/.jetbrains/acp.json 파일에 추가하세요:

file:

{
"agent_servers": {
"Kimi CLI": {
...

그러면 IDE의 에이전트 패널에서 Kimi CLI 스레드를 생성할 수 있습니다.

Zsh와 함께 Kimi CLI를 사용하면 AI 에이전트 기능을 통해 쉘 경험을 향상시킬 수 있습니다.

다음 명령어를 통해 zsh-kimi-cli 플러그인을 설치하세요:

git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli

참고

Oh My Zsh 외의 다른 플러그인 매니저를 사용하는 경우, 해당 플러그인의 README에서 설치 지침을 참조해야 할 수 있습니다.

그리고 다음 내용을 ~/.zshrc 파일에 추가하세요:

plugins=(... kimi-cli)

Zsh를 재시작한 후, Ctrl-X를 눌러 에이전트 모드(agent mode)로 전환할 수 있습니다.

Kimi CLI는 MCP (Model Context Protocol) 도구를 지원합니다.

kimi mcp 서브 명령어 그룹

kimi mcp 서브 명령어 그룹을 사용하여 MCP 서버를 관리할 수 있습니다. 예를 들면:

# 스트리밍 가능한 HTTP 서버 추가:
kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"
# OAuth 인증을 사용하는 스트리밍 가능한 HTTP 서버 추가:
...

임시 MCP 설정 (Ad-hoc MCP configuration)

Kimi CLI는 또한 CLI 옵션을 통해 임시 MCP 서버 구성을 지원합니다. 다음과 같은 잘 알려진 MCP 구성 형식의 MCP 설정 파일이 주어졌을 때:

{
"mcpServers": {
"context7": {
...

--mcp-config-file 옵션을 사용하여 kimi를 실행하면 지정된 MCP 서버에 연결할 수 있습니다:
kimi --mcp-config-file /path/to/mcp.json

더 많은 기능은 Documentation을 참조하세요.

Kimi CLI를 개발하려면 다음 명령어를 실행하세요:

git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli
make prepare # 개발 환경 준비

그런 다음 Kimi CLI 작업을 시작할 수 있습니다.

변경 사항을 적용한 후에는 다음 명령어를 참조하세요:

uv run kimi # Kimi CLI 실행
make format # 코드 형식 지정
make check # 린팅 및 타입 검사 실행
...

참고: make build와 make build-bin은 웹 UI를 임베드하기 위해 자동으로 make build-web을 실행합니다.