Kimi Code 데스크톱 앱 알아보기: 네이티브 데스크톱 앱으로 스마트하게 코딩하세요

Kimi Code 데스크톱은 프로그래밍용 데스크톱 애플리케이션이자 Kimi Code의 공식 데스크톱 버전입니다. Kimi Code의 AI 프로그래밍 기능을 데스크톱 환경으로 가져옵니다. 대화를 통해 에이전트에게 코드를 읽고 작성하게 하고, 명령을 실행하며, 작업을 자동으로 수행하도록 할 수 있습니다. 새로운 시각적 인터페이스에서는 모든 프로젝트를 한곳에서 관리하고, 자주 쓰는 설정을 조정하며, 에이전트 작업의 모든 단계를 추적할 수 있습니다.

Kimi Code 데스크톱을 사용해 프로토타입을 개발하고, 개인용 애플리케이션을 구축하거나, 기존 코드베이스를 수정할 수 있습니다. 프로젝트는 자체 종속성, 개발 도구, 테스트 명령을 그대로 사용하며, 이곳에서 작업을 위임하고 결과를 검토할 수 있습니다.

워크스페이스는 로컬 프로젝트 폴더이며, 이를 기준으로 대화를 분류할 수 있습니다. 특정 프로젝트로 돌아가거나 이전 세션을 검색하고, 완료된 작업을 보관할 수 있습니다. 버그 수정, 기능 개발, 탐색적 문제 해결에 각각 별도의 대화가 필요할 때 특히 유용합니다.

대화를 분기해 다른 방안을 탐색할 수도 있습니다. 주요 작업과 별개로 빠르게 질문하려면 사이드 채팅에서 해당 컨텍스트의 임시 읽기 전용 사본을 제공합니다. 데스크톱은 CLI와 로컬 세션 데이터를 공유하므로, 데스크톱에서 기존 CLI 작업을 이어갈 수 있습니다. 두 인터페이스가 동시에 열려 있다면 최근 활동을 확인하기 위해 다시 로드해야 할 수 있습니다. 자세한 내용은 프로젝트 및 세션 관리를 참조하세요.

메인 창의 왼쪽에는 프로젝트와 세션이 표시되고, 가운데에는 대화, 오른쪽에는 보조 패널, 아래에는 터미널이 배치됩니다. 도구 활동을 추적하면서 관련 파일이나 페이지를 가까이에 둘 수 있습니다.

이 레이아웃은 실용적인 검토 과정을 지원합니다. 수정 사항을 확인하고, 명령 출력 결과를 살펴보고, 페이지를 열어 정확한 피드백을 제공할 수 있습니다. UI 변경의 경우 대화에는 구현 방식이 설명되고, 차이 보기에는 변경 범위가 표시되며, 브라우저에서는 평가해야 할 동작을 보여 줍니다.

Kimi Code 데스크톱은 간단한 흐름으로 사용할 수 있습니다. 프로젝트를 열고, 변경할 내용을 설명한 다음, 결과를 검증합니다. 다음 단계에서는 첫 요청부터 검증 가능한 결과까지 작은 변경 하나를 완료하면서 에이전트가 어디서 작업하고 개발자가 어디서 검토하는지 보여 줍니다. 이 워크플로에 익숙해지면 같은 과정으로 더 큰 작업도 처리할 수 있습니다.

1단계: 컴퓨터에 맞는 설치 패키지 선택

Kimi Code 공식 페이지에서 Kimi Code 데스크톱 앱을 다운로드하고, 사용하는 시스템에 맞는 패키지를 선택하세요.

Mac에서는 ‘이 Mac에 관하여’에서 칩 유형을 확인하세요. Linux의 경우 Debian 또는 Ubuntu 배포판은 DEB를, Fedora 또는 RHEL 배포판은 RPM을, 휴대용 패키지는 AppImage를 선택하세요.

2단계: 모델 연결 및 프로젝트 열기

데스크톱 앱을 실행한 후 해당 Kimi Code 멤버십 혜택이 있는 Kimi 계정으로 로그인하면 공식 모델을 사용할 수 있습니다.

또는 ‘설정’에서 타사 서비스 제공업체의 API 키, 기본 URL, 모델 정보를 사용해 해당 서비스 제공업체를 추가할 수 있습니다. 모델 및 서비스 제공업체의 전체 세부 정보는 모델 구성을 참조하세요.

설정을 마쳤으면 세션을 만들고 메시지 입력창 위의 폴더 이름을 클릭한 다음 로컬 프로젝트를 선택하세요. 선택한 폴더를 확인하고 모든 작업 영역 신뢰 메시지를 검토하세요. 먼저 프로젝트를 읽기만 하는 요청을 해보세요.

이렇게 하면 에이전트에게 수정을 요청하기 전에 프로젝트를 어떻게 이해하고 있는지 확인할 수 있습니다.

기존 문의 양식에서 이름, 이메일 주소, 메시지를 필수로 입력해야 한다고 가정해 보겠습니다. 다음 예시는 프로젝트에서 작업을 구성하고 결과를 평가하는 방법을 보여 줍니다.

에이전트에게 확인 가능한 요구 사항을 제공하세요. @ 멘션으로 양식 파일을 참조하거나, 스크린샷을 첨부하거나, 문제를 재현하는 단계를 설명할 수 있습니다. Kimi Code 데스크톱 앱의 컨텍스트 도구는 요청을 관련 코드 및 페이지와 연결하는 데 도움이 됩니다.

이러한 요구 사항은 여러분과 에이전트가 검토할 수 있는 구체적인 기준을 제공하고 경계도 명확히 합니다. 유효성 검사를 위한 수정이 별도 설명 없이 재설계나 제출 서비스 교체로 이어져서는 안 됩니다.

수정을 시작하기 전에 계획을 검토하려면 ‘계획’을 선택하세요. 제안된 작업이 양식 컴포넌트, 기존 유효성 검사 패턴, 적절한 테스트를 포함하는지 확인하세요. 계획에 불필요한 종속성이 추가되거나 관련 없는 동작이 변경된다면 수정을 요청하세요.

계획을 승인한 후 대화에서 도구 활동을 추적하세요. 승인 요청을 읽고 요구 사항에 관한 질문에 답하세요. 추가 제약 조건이 발견되면 작업 진행 중에도 세션에 추가할 수 있습니다.

유지할 제어 수준도 선택할 수 있습니다. Kimi Code 데스크톱 앱에서는 각 사용자가 에이전트에 어느 정도의 자율성을 부여할지 결정할 수 있습니다. 권한 설정은 에이전트가 작업을 수행하기 전에 승인을 기다리며 일시 중지해야 하는 시점을 결정합니다.

• 항상 묻기: 읽기 작업은 자동으로 실행되며, 그 밖의 작업은 승인이 필요합니다.

• 필요할 때 묻기: 에이전트는 일반적인 단계를 계속 수행하고, 작업에 확인이 필요할 때만 일시 중지합니다. 이 방식은 일상 작업에서 속도와 제어 사이의 균형을 맞춥니다.

• 묻지 않기: 현재 권한 범위 내에서 작업이 실행되며, 항목별 승인 요청이 표시되지 않습니다.

이 설정은 언제든 조정할 수 있으므로, 프로젝트 초반에는 더 엄격하게 제어하다가 신뢰가 쌓이면 점차 완화할 수 있습니다.

‘변경 사항’ 보기를 열고 원래 요구 사항과 비교하며 차이점을 확인하세요. 이 예시에서는 다음을 확인하세요.

• 공백 문자만 입력된 경우를 포함해 지정한 세 가지 필수 필드가 모두 처리되었는가?

• 잘못된 입력이 제출을 막는지, 사용자가 어떤 필드를 처리해야 하는지 이해할 수 있는지 확인하세요.

• 입력을 수정한 후 오류 메시지가 적절히 사라지거나 업데이트되는지 확인하세요.

• 유효한 입력은 기존 제출 처리기로 계속 전달되는지 확인하세요.

• 변경 사항이 양식 및 관련 테스트로만 제한되는지 확인하세요.

불명확한 부분이 있다면 관련 코드를 인용하고 변경 이유를 물어보세요. 예를 들어 “왜 여기서 제출 처리기를 교체했나요?”처럼 초점을 맞춘 질문을 하면 에이전트가 구체적인 결정에 관해 설명하거나 수정할 수 있습니다.

프로젝트 문서에 명시된 검사 방법을 사용하고 명령어를 추측하지 마세요. 터미널에서 직접 검사를 실행하거나 에이전트에게 실행하도록 할 수 있습니다. 명령어, 실행 결과, 실행할 수 없는 검사에 대한 설명을 요청하세요. 완료 메시지만으로는 어떤 동작이 검증되었는지 알 수 없습니다.

다음으로 로컬 애플리케이션을 시작하고 내장 브라우저에서 시작 출력에 표시된 실제 URL을 여세요. 빈 양식 제출, 필드별 입력, 잘못된 이메일 입력을 차례로 시도한 뒤, 적절한 개발 환경에서 유효한 테스트 데이터를 제출하세요. 데스크톱과 좁은 뷰포트 너비에서 오류 메시지의 위치를 확인하세요.

오류 메시지가 제출 버튼과 겹친다면 해당 요소를 표시하고 예상 간격을 설명하세요. 브라우저는 요소 컨텍스트와 선택적으로 스크린샷을 에이전트에게 다시 보낼 수 있습니다. 수정 후 영향을 받은 검사를 다시 실행하세요. 마지막으로 변경된 내용, 통과한 검사, 아직 검증되지 않은 내용을 명확히 설명하세요.

작고 명확하게 정의된 변경은 바로 실행할 수 있습니다. 범위가 커지면 작업을 구성하려는 방식에 맞는 모드를 선택하세요.

Tower는 더 큰 목표를 위한 실험적 옵션으로, 에이전트가 필요에 따라 격리된 작업 트리를 사용하고 병합 전에 변경 사항을 검토합니다. 실행 가이드에서 이러한 모드를 소개합니다.

기본 검토 주기가 사용 방식에 맞게 자리 잡으면 반복 작업을 위해 더 많은 기능을 추가할 수 있습니다. 스킬로 검토 절차나 프로젝트 규칙을 축적할 수 있습니다. 플러그인과 MCP 통합은 추가 도구와 서비스 또는 데이터 소스에 대한 접근을 제공합니다. 설정 및 확장 가이드에서 구성 방법을 설명합니다.

Kimi Code 데스크톱은 정보를 수집하고 프로그래밍 관련 문제를 조사하며, 익숙하지 않은 오픈 소스 프로젝트를 이해하는 데도 도움을 줍니다. 예를 들어 GitHub 링크를 공유하고 에이전트에게 프로젝트의 용도, 주요 구성 요소의 협업 방식, 읽기 또는 학습을 위한 권장 사항을 설명해 달라고 요청할 수 있습니다.

내장 브라우저는 원본 자료를 대화 옆에 유지합니다. 아래 예시에서 에이전트는 GitHub 리포지토리를 탐색하고 프로젝트 페이지를 읽으며, 소개 글을 작성할 때 기술적 주장과 라이선스 세부 정보를 확인합니다.

후속 질문으로 학습 방향을 잡으세요. 어떤 리포지토리가 목표와 관련 있는지, 구성 요구 사항은 무엇인지, 또는 특정 주장을 뒷받침하는 문서는 무엇인지 물어보세요. 이렇게 하면 프로젝트 탐색의 출발점을 마련하고 원본 자료를 바탕으로 에이전트의 결론을 확인할 수 있습니다.

브라우저 관련 작업을 할 때는 적절한 통합 방식을 선택하세요. 내장 브라우저는 Desktop에서 페이지를 열고, 기존 로그인 상태가 필요한 작업에서는 WebBridge가 에이전트를 실제 브라우저에 연결합니다.

책상을 떠난다고 해서 프로그래밍 작업을 중단할 필요는 없습니다. 원격 제어를 사용하면 휴대폰, 태블릿 또는 다른 컴퓨터에서 실행 진행 상황을 확인하고, 도구의 입력과 출력을 검토하며, 승인 요청에 응답하고, 후속 지시를 보낼 수 있습니다. 새 세션을 시작하거나 실행 중인 작업을 중지할 수도 있습니다.

연결하려면 데스크톱의 설정 → 원격 제어에서 원격 제어를 활성화하세요. 다른 기기로 QR 코드를 스캔하거나 브라우저에서 액세스 링크를 열고, 동일한 Kimi 계정으로 로그인한 다음 안내에 따라 원격 액세스를 활성화하세요.

원래 사용하던 컴퓨터는 계속 실행 환경으로 유지됩니다. 파일, 명령어, 로컬 도구는 모두 해당 기기에 남아 있습니다. 컴퓨터가 절전 상태로 전환되지 않도록 하고, 인터넷에 연결된 상태에서 Desktop을 실행해 두세요. 원격 브라우저 페이지를 닫아도 진행 중인 작업은 중지되지 않습니다. 원격 액세스를 종료하려면 데스크톱 설정에서 원격 제어를 비활성화하거나 데스크톱을 종료하세요.

클라이언트 다운로드와 모델 액세스는 별개의 단계입니다. Kimi 공식 모델을 사용하려면 자격 요건을 충족하는 멤버십이 필요합니다. 현재 새 요금제는 Plus부터 모두 Kimi Code를 포함합니다. 현재 이용 가능한 모델은 K3.1 Pro 및 K3.1 Pro 고속 버전, K3, K2.8 Preview, K2.7 Code 고속 버전이며, 요금제와 시기에 따라 모델 접근 권한 및 컨텍스트 제한이 달라질 수 있습니다. 현재 세부 사항은 모델 구성 가이드에서 확인하세요.

Kimi 멤버십 할당량 규정 내에서 데스크톱, CLI, VS Code 등 Kimi Code 접점은 사용량을 공유합니다. 새 요금제에는 5시간 단위의 롤링 속도 제한 창과 월간 총 할당량이 유지되며, 기존 요금제에는 주 단위 창을 포함한 다른 규칙이 적용됩니다. 5시간 창은 속도 제한이며, 애플리케이션을 5시간 동안 고정적으로 사용할 수 있다는 의미는 아닙니다.

현재 요금제를 확인하고 멤버십 가이드를 참고한 뒤, 데스크톱의 “설정”에서 계정 사용량을 확인하세요. 다른 모델 제공업체를 구성한 경우 해당 업체의 가용성, 호환성 및 비용은 별도로 적용됩니다.

Kimi Code 데스크톱은 시각화된 작업 공간을 제공하여 프로그래밍 작업을 대화에서 검토하고 테스트할 수 있는 변경 사항으로 발전시킬 수 있도록 돕습니다. 프로토타입을 만들거나 기존 애플리케이션을 개선할 때 프로젝트, 에이전트의 작업, 검토를 한곳에 모으고 각 작업에 필요한 승인 수준을 결정할 수 있습니다. 익숙한 프로젝트와 승인 기준이 명확한 변경 사항부터 시작하세요. 목표를 설명하고, 계획을 검토한 뒤, 터미널과 브라우저에서 결과를 확인하세요.