Kimi Code CLI로 Blender 다루기: 설치·로그인·MCP·스킬

기준: Kimi Code CLI 공식 문서(설치, 로그인, MCP, 권한, 스킬, 2.3.2), Kimi API 플랫폼의 K3.1 Pro 안내, Blender Lab의 Blender MCP Server 안내(애드온 1.0.3, Blender 5.2), Blender Agent Skills 저장소(1.1.0). 2026년 10월에 확인했습니다. 이 글의 Kimi Code 설정 순서는 공식 문서를 기준으로 썼고, Kimi Code 화면은 넣지 않았습니다. 그림은 모두 실제 Blender 화면입니다.

Kimi Code CLI는 터미널에서 일하는 AI 에이전트이고, Blender와는 MCP와 스킬 두 가지로 이어집니다. MCP는 열려 있는 Blender를 직접 움직이는 연결이고, 스킬은 "Blender 일은 이런 순서로 하라"는 설명서 묶음입니다. 둘 다 정해진 폴더에 파일을 넣으면 됩니다.

Kimi는 중국 AI 회사 Moonshot AI가 만든 AI 서비스 이름입니다. Kimi Code CLI는 그 회사가 내놓은 코딩 에이전트로, 파일을 읽고 쓰고 명령을 실행하면서 일을 해 나갑니다. Claude Code나 Codex와 같은 종류의 도구라고 보면 됩니다.

이 글을 마치면 아래를 할 수 있습니다.

1. Kimi Code CLI를 Windows에 설치하고 로그인합니다.
2. Blender 공식 MCP 서버를 mcp.json에 등록하고 연결 상태를 확인합니다.
3. 세 가지 권한 모드의 차이를 알고 Blender 작업에 맞는 모드를 고릅니다.
4. Blender 스킬을 스킬 폴더에 넣고 /skill: 명령으로 부릅니다.
5. 만든 모델을 검사 스크립트로 확인하고 고치는 흐름을 알아 둡니다.

Kimi, K3.1 Pro, Kimi Code CLI

매개변수는 모델 안에 든 숫자의 개수입니다. 책장에 꽂힌 책의 권수처럼, 많을수록 담을 수 있는 지식이 많다고 보면 됩니다. 다만 크다고 모든 일을 더 잘하는 것은 아닙니다.

K3.1 Pro 안내에는 "MCP 연결에 기대지 않고도 전문 모델링 도구용 스크립트를 쓰고 실행할 수 있다"는 설명이 있습니다. AI가 Blender를 움직이는 길이 스크립트와 MCP 두 가지라는 뜻입니다. 두 길의 차이는 Blender와 AI 연결: MCP·스크립트로 3D 작업 시키기에 있습니다. 이 글은 두 길을 모두 씁니다.

1단계: 설치

시작 상태: Kimi Code CLI를 한 번도 설치하지 않은 Windows에서 시작합니다.

Windows에서는 Kimi Code CLI가 Git for Windows에 들어 있는 Git Bash를 셸(명령을 받아 실행하는 창구)로 씁니다. 그래서 공식 문서는 처음 실행하기 전에 Git for Windows를 먼저 설치하라고 안내합니다.

따라 하기:

1. Git for Windows(gitforwindows.org)를 설치합니다.
2. PowerShell을 열고 공식 설치 스크립트를 실행합니다.

irm https://code.kimi.com/kimi-code/install.ps1 | iex

3. 새 터미널 창을 열고 작업할 폴더로 옮긴 뒤 kimi를 입력합니다.

설치 스크립트는 최신판을 받아 검사값(checksum)을 확인하고, kimi 명령을 어느 폴더에서나 쓸 수 있게 놓아 줍니다. Node.js 22.19.0 이상이 있으면 npm install -g @moonshot-ai/kimi-code로 설치해도 됩니다. Git Bash를 기본이 아닌 곳에 설치했다면 KIMI_SHELL_PATH 환경 변수에 bash.exe의 전체 경로를 넣습니다.

예전 Kimi CLI를 쓰던 경우: 새 Kimi Code CLI를 처음 실행하면 예전 데이터를 찾아 옮길지 묻습니다. 나중에 kimi migrate로 옮겨도 됩니다. 설정과 MCP 서버 목록은 옮겨지지만 로그인 정보는 옮겨지지 않아 다시 로그인해야 합니다.

2단계: 로그인

시작 상태: 1단계에서 kimi를 실행해 대화 화면이 열린 상태에서 이어 갑니다.

따라 하기:

1. 입력 칸에 /login을 넣고 Enter를 누릅니다.
2. 둘 가운데 하나를 고릅니다.
   • Kimi Code (OAuth): 화면에 나온 링크를 아무 기기에서나 열어 로그인하고, 화면의 코드를 넣어 허락합니다.
   • Kimi Platform API key: Kimi 플랫폼에서 받은 API 키를 넣습니다.
3. 로그아웃은 /logout입니다.

OAuth는 비밀번호를 앱에 직접 주지 않고, 내가 로그인한 웹 화면에서 "이 앱에 권한을 준다"고 허락하는 방식입니다. 호텔 프런트에서 방 열쇠 카드만 받고 마스터키는 맡기지 않는 것과 비슷합니다. 어떤 모델을 얼마나 쓸 수 있는지는 요금제마다 다르니 공식 요금 안내를 확인하세요.

3단계: Blender 쪽 준비

시작 상태: Blender 5.1 이상에 Blender Lab의 공식 MCP 애드온을 설치한 상태에서 시작합니다. 설치법은 Blender 공식 MCP 설치하기에 있습니다.

따라 하기:

1. Blender를 켜고 Edit ‣ Preferences…를 엽니다.
2. Add-ons에서 MCP를 검색하고 줄을 펼칩니다.
3. 맨 아래에 Server is running이 보이는지 봅니다. 없으면 Start MCP Bridge Server를 누릅니다.

Maintainer Blender Lab, Version 1.0.3, Host localhost·Port 9876, Auto Start 켜짐, 맨 아래 Server is running (Blender 화면 캡처)

따라 하기(서버 받기): MCP 서버는 Blender 바깥에서 도는 작은 프로그램입니다. 이 서버는 uv라는 실행 도구로 띄웁니다. uv는 파이썬 프로그램을 필요한 부품과 함께 실행해 주는 도구로, 재료를 알아서 꺼내 와 차려 주는 보조 요리사와 비슷합니다.

1. PowerShell에서 uv 공식 설치 안내의 Windows 명령으로 uv를 설치합니다.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. PowerShell 창을 새로 열고 uv --version을 입력합니다. 버전 번호가 한 줄 나오면 설치된 것입니다.
3. 같은 창에서 공식 저장소를 받습니다.

cd C:\
git clone https://projects.blender.org/lab/blender_mcp.git

받은 폴더의 C:\blender_mcp\mcp가 서버 자리입니다.

4단계: mcp.json에 Blender 등록

시작 상태: 3단계에서 Server is running을 확인하고 서버를 받은 상태에서 이어 갑니다.

Kimi Code는 MCP 서버 목록을 mcp.json 파일에 적습니다. 자리는 둘입니다.

따라 하기:

1. 사용자 폴더의 .kimi-code\mcp.json을 메모장으로 엽니다. 없으면 새로 만듭니다.
2. 아래 내용을 넣고 저장합니다.

{
  "mcpServers": {
    "blender": {
      "command": "uv",
      "args": ["--directory", "C:\\blender_mcp\\mcp", "run", "blender-mcp"],
      "startupTimeoutMs": 60000
    }
  }
}

3. kimi를 새로 실행하고 /mcp를 입력해 blender가 연결됐는지 봅니다.

• command가 있으면 Kimi Code는 이 서버를 같은 컴퓨터 안에서 띄우는 방식(stdio)으로 압니다.
• JSON에서는 역슬래시를 두 번(\\) 씁니다. 한 번만 쓰면 파일을 읽지 못합니다.
• startupTimeoutMs는 서버가 켜질 때까지 기다리는 시간(밀리초)입니다. 기본값은 30000(30초)입니다. 처음 실행할 때는 uv가 필요한 부품을 받느라 오래 걸릴 수 있어 60초로 늘려 두었습니다.

파일을 직접 고치기 싫다면 대화 화면에서 /mcp-config를 입력합니다. 서버를 더하고, 고치고, 지우는 일을 대화식으로 할 수 있습니다. 대화 도중에 mcp.json을 고치면 이미 열린 대화에는 들어가지 않고, 새로 연 대화부터 적용됩니다.

프로젝트 폴더의 mcp.json은 조심하세요. 공식 문서는 프로젝트 폴더의 .kimi-code\mcp.json에 적힌 서버가 대화를 시작할 때 내 컴퓨터에서 명령을 실행한다고 경고합니다. 남에게 받은 폴더라면 이 파일부터 열어 무엇을 실행하는지 읽어 보세요.

5단계: 권한 모드 고르기

Kimi Code에는 AI가 무엇을 할 때 나에게 물을지 정하는 모드가 셋 있습니다.

공식 문서는 Ask When Needed 모드에서는 MCP 도구 호출이 저절로 허락된다고 밝히고, 연결한 MCP 서버를 완전히 믿을 때만 쓰라고 권합니다. Blender Lab도 이 MCP 서버가 AI가 만든 코드를 보호 장치 없이 Blender에서 실행한다고 경고합니다.

그래서 Blender를 처음 붙였을 때는 기본값인 Always Ask로 시작하세요. 승인 창이 뜨면 화살표로 고르고 Enter를 누르거나, Esc로 거절합니다. 같은 종류의 호출을 이 대화 동안 계속 허락하는 선택지도 있습니다. 작업 방식에 익숙해진 뒤, 복사본 파일로만 일할 때 다른 모드를 생각해 보면 됩니다.

6단계: Blender 스킬 넣기

스킬은 SKILL.md라는 설명 파일과 그 옆의 스크립트를 한 폴더에 묶은 것입니다. 요리책 한 권에 레시피와 계량 도구가 같이 들어 있는 모습을 떠올리면 됩니다. AI는 일을 받으면 맞는 스킬의 설명을 읽고, 그 안의 스크립트를 실행해 결과를 확인합니다.

Kimi Code가 스킬을 찾는 폴더는 아래와 같습니다.

여기서 "프로젝트 맨 위 폴더"는 작업 폴더에서 위로 올라가며 찾은, .git 폴더가 있는 가장 가까운 폴더입니다. .git은 git으로 관리하는 폴더에만 생기는 숨김 폴더입니다. git을 쓰지 않는 폴더에서 일한다면 프로젝트 자리가 정해지지 않아 스킬이 읽히지 않을 수 있습니다. 처음에는 사용자 전체 자리(사용자 폴더의 .agents\skills\)에 두는 쪽이 헷갈리지 않습니다.

스킬 폴더 안에는 스킬마다 하위 폴더를 하나씩 두고, 그 안에 SKILL.md를 둡니다. 다른 도구용으로 받은 스킬이 .claude\skills\ 같은 폴더에 있다면, Kimi Code 문서가 안내하는 위 폴더로 옮겨야 읽힙니다.

예: Blender Agent Skills

공개된 Blender 스킬 묶음 가운데 하나로 Blender Agent Skills(MIT 라이선스)가 있습니다. 모델링, UV, 재질, 리깅, 렌더, 내보내기, 검사까지 스킬 22개가 들어 있고, Blender 5.2 이상을 기준으로 만들었다고 저장소가 밝힙니다. 이 저장소의 설명에 따르면 .agents\skills는 여러 에이전트가 함께 읽는 자리입니다.

따라 하기:

1. 저장소를 받습니다: git clone https://github.com/EL4CTEO/blender-skills
2. 받은 폴더의 skills 안에서 필요한 스킬 폴더만 골라, 사용자 폴더의 .agents\skills\로 복사합니다. git으로 관리하는 프로젝트에서만 쓰려면 그 프로젝트 맨 위 폴더의 .agents\skills\로 복사합니다. 처음에는 blender-core(시작점)와 blender-asset-qa(검사) 둘이면 충분합니다.
3. 복사하기 전에 스킬 안의 스크립트를 한 번 훑어보세요. 인터넷에 접속하거나 파일을 지우는 코드가 있는지, Blender를 어떤 옵션으로 띄우는지 확인합니다.
4. kimi를 새로 실행하고 입력 칸 맨 앞에 /skill:blender-asset-qa처럼 스킬 이름을 붙여 부릅니다. 이름 뒤에 한 칸 띄우고 할 일을 이어 쓸 수 있습니다. 공식 예시도 /skill:git-commits fix concurrency issue in login endpoint처럼 이름 뒤를 한 칸 띄웁니다.

저장소의 설치 스크립트를 그대로 돌리면 기본으로 사용자 전체 폴더(.claude\skills, .agents\skills)에 모두 깔립니다. 한 프로젝트에서만 쓰려면 위처럼 필요한 것만 직접 복사하는 쪽이 정리하기 쉽습니다.

7단계: 만들고, 검사하고, 고치기

시작 상태: 4단계와 6단계를 마치고, Blender에 빈 장면을 복사본 파일로 연 상태에서 시작합니다.

AI에게 3D 모델을 맡길 때 가장 흔한 사고는 부품이 몸체에서 떨어져 공중에 떠 있는 것입니다. 화면 한쪽에서는 붙어 보여도 다른 각도에서 보면 떠 있습니다. 그래서 만든 뒤에는 숫자로 검사하는 단계를 꼭 둡니다.

따라 하기: 과제를 셋으로 나눠 맡깁니다.

1. "원통 몸체, 날개, 꼬리 판으로 단순한 비행기 블록아웃을 만들어 줘. 부품 이름을 영어로 붙여 줘."
2. /skill:blender-asset-qa 방금 만든 부품을 검사하고, 오류와 경고를 표로 보여 줘. (이 줄은 입력 칸 맨 앞에서 시작하고, 스킬 이름 뒤를 한 칸 띄웁니다.)
3. "오류만 고치고 다시 검사해 줘. 경고는 고칠지 나에게 물어봐."

블록아웃(blockout)은 상자와 원통 같은 단순한 모양으로 크기와 배치만 잡은 초벌 모델입니다. 건물을 짓기 전에 종이 상자로 만드는 모형과 같습니다.

아래 두 그림은 검사 스크립트가 무엇을 잡는지 보여 줍니다. 이 그림은 Kimi Code를 거치지 않고, 스킬 안의 검사 스크립트를 Blender에서 직접 실행해 찍었습니다. 일부러 작은 상자(Stray) 하나를 몸체 위에 띄워 놓고 검사했습니다.

검사 전. 작은 상자 Stray가 몸체 위 공중에 떠 있음. 그림은 Solid 보기에서 물체마다 다른 색을 칠한 화면입니다 (Blender 화면 캡처)

이 상태에서 검사 스크립트는 통과하지 못했다(pass: false)고 답했고, 오류 한 줄을 냈습니다.

floating/detached part in Stray (8 verts at [0.0, 0.0, 4.0])

"Stray라는 부품이 떨어져 떠 있고, 점 8개가 높이 4.0 m 자리에 있다"는 뜻입니다. 경고도 일곱 줄 나왔습니다. 재질이 비어 있는 부품, 크기(Scale) 값을 적용하지 않은 날개와 꼬리, 모델 바닥이 높이 0에 놓이지 않은 것이었습니다. 블록아웃 단계에서는 이런 경고를 바로 고치지 않아도 되므로, 경고는 고칠지 사람이 정하게 했습니다.

고친 뒤. Stray를 몸체 윗면에 닿게 내리고 다시 검사하니 오류 0개, pass: true (Blender 화면 캡처)

따라 하기: 검사 결과를 받으면 아래 순서로 봅니다.

1. errors(오류)가 비었는지 봅니다. 하나라도 있으면 "오류만 고치고 다시 검사해 줘"라고 맡깁니다.
2. warnings(경고)를 한 줄씩 읽고, 지금 고칠지 나중에 고칠지 정해 AI에게 알려 줍니다.
3. 숫자가 통과해도 3D 뷰포트에서 여러 각도로 돌려 봅니다. 비율이 이상한 것, 부품이 서로 파고든 것은 검사 스크립트가 다 잡지 못합니다.

자주 하는 실수와 해결

한 줄 정리

Git for Windows 먼저, 설치 스크립트 한 줄, /login, mcp.json에 Blender 한 단락, 스킬은 .agents\skills\에, 처음에는 Always Ask. 만든 모델은 검사 스크립트로 숫자를 보고, 화면으로 한 번 더 확인하세요.

함께 읽기

• Blender 공식 MCP 설치하기
• Claude Code에 Blender 공식 MCP 붙이기
• Codex와 GPT-6 Astra로 Blender 다루기
• Blender와 AI 연결: MCP·스크립트로 3D 작업 시키기
• MCP란 무엇인가: AI에 도구를 꽂는 USB-C 같은 표준
• Claude·ChatGPT·Gemini와 미국·중국 AI 서비스 비교: 요금, 개인정보, 고르는 법

참고 자료

• Kimi Code CLI 문서(시작하기, MCP, 권한 모드, 스킬, 바뀐 점): https://moonshotai.github.io/kimi-code/
• Kimi API 플랫폼, Kimi K3.1 Pro Quickstart: https://platform.kimi.ai/docs/guide/kimi-k3-1-pro-quickstart
• Blender Lab, Blender MCP Server: https://www.blender.org/lab/mcp-server/
• Blender Lab, blender_mcp 저장소: https://projects.blender.org/lab/blender_mcp
• Blender Agent Skills 저장소: https://github.com/EL4CTEO/blender-skills
• uv, Installation: https://docs.astral.sh/uv/getting-started/installation/
• 그림: Blender 5.2 화면 캡처(공식 MCP 애드온 1.0.3, Blender Agent Skills 1.1.0의 검사 스크립트)