복잡한 설정 없이 코딩에 사용할 AI 모델을 직접 쓰고 싶으신가요? Droid는 CLI에서 외부 API를 지원하므로 작업 흐름에 맞는 사용자 지정 모델을 연결할 수 있습니다. 이 가이드에서는 API 설정, 일반적인 문제 해결, Droid에서 Kimi를 사용하는 방법을 안내합니다. 계속 읽고 시작해 보세요.
Droid란 무엇인가요?
Droid는 개발자가 코드를 작성하고 오류를 해결하며 개발 작업을 더 효율적으로 처리하도록 돕는 AI 코딩 도구입니다. 내장 AI 모델을 지원하며, 더 유연하게 사용하도록 CLI를 통해 사용자 지정 모델을 연결할 수도 있습니다. 빠른 도움이 필요할 때나 개인화된 설정이 필요할 때 등 다양한 코딩 작업 흐름에 유용합니다.
Droid에서 내장 AI 모델을 사용하는 방법
내장 AI 모델을 사용하면 외부 API를 먼저 연결하지 않아도 Droid로 코딩을 시작할 수 있습니다. 앱을 설치한 후 플랫폼 내에서 모델을 선택하면 코드 분석, 기능 개발, 버그 수정, 리뷰를 위한 AI 지원을 이용할 수 있습니다. Droid를 시작하는 방법은 다음과 같습니다.
1단계: Droid 설치 및 실행
먼저 기기에 Factory App을 다운로드하고 설치를 완료하세요. এরপর 앱을 열고 계정에 로그인합니다. 그러면 앱 내에서 Droid와 내장 AI 기능을 사용할 수 있습니다.
2단계: Droid를 프로젝트 폴더에 연결
작업할 코드베이스로 작업 디렉터리를 설정합니다. 그러면 Droid가 로컬 프로젝트에 연결되어 파일을 읽고 코드 구조를 파악하며, 더 정확한 맥락을 바탕으로 개발 작업을 지원할 수 있습니다.
3단계: 내장 모델을 선택하고 프롬프트 입력 시작
모델 선택기를 열고 Droid에서 사용할 수 있는 내장 AI 모델 중 하나를 선택합니다. 모델을 선택한 뒤에는 코드베이스 분석, 버그 수정, 코드 리뷰, 기능 구현 등을 요청하는 프롬프트를 입력할 수 있습니다.
Droid를 외부 API에 연결하는 방법
Droid를 외부 API에 연결하면 내장 옵션에만 제한되지 않고 원하는 모델을 더 자유롭게 사용할 수 있습니다. 설정 파일에 사용자 지정 모델을 추가하는 방식으로 Droid CLI에서 설정하며, 저장하면 /model 메뉴에서 모델을 사용할 수 있습니다. 아래 단계에서는 Kimi를 간단한 예시로 사용해 API 키 설정부터 모델 선택까지 전체 설정 과정을 보여드립니다:
1단계: Moonshot AI에서 Kimi API 키 받기
먼저 Moonshot AI에서 Kimi API 키를 생성하거나 복사합니다. Droid는 이 키를 사용해 Kimi API에 연결하고 계정을 통해 요청을 전송하므로 필요합니다. 설정 파일에서 안전하게 사용할 수 있도록 키를 MOONSHOT_API_KEY와 같은 환경 변수로 저장하는 것이 좋습니다.
2단계: Droid 설정 파일 열기
다음으로 Droid CLI에서 사용자 지정 모델을 추가하는 설정 파일을 엽니다. macOS에서는 파일 경로가 ~/.factory/settings.json입니다. Windows PowerShell에서는 %USERPROFILE%\.factory\settings.json를 사용합니다. 이 파일은 Droid가 사용자 지정 모델 구성을 읽는 기본 파일입니다.
3단계: Kimi를 사용자 지정 모델로 추가하기
settings.json에서 customModels 배열 아래에 Kimi를 추가합니다. 이를 통해 Droid에 사용할 모델, 호출할 API 엔드포인트, 따르는 제공업체 형식, 인증에 사용할 API 키를 지정할 수 있습니다. 파일에 이미 다른 설정이 있다면 전체 내용을 교체하지 말고, 기존 customModels 배열 안에 이 모델 객체만 추가하세요.
4단계: 파일 저장 후 Droid 재시작하기
구성을 추가한 후 파일을 저장하고 Droid CLI를 재시작합니다. 그러면 Droid가 업데이트된 설정을 다시 불러오고 새로 추가한 사용자 지정 모델을 올바르게 인식합니다.
5단계: Droid에서 /model로 Kimi 모델 선택하기
Droid CLI를 열고 /model 명령을 실행합니다. 이제 Custom models 섹션에 Kimi 설정이 표시됩니다. 목록에서 선택하여 코딩 세션의 활성 모델로 Kimi를 지정합니다.
6단계: 작업 실행하기
Kimi를 선택한 후에는 Droid에서 실제 작업에 사용할 수 있습니다. 코드 검토, 버그 수정, 코드베이스 설명과 같은 프롬프트를 시도해 보세요. Droid는 Kimi API를 통해 요청을 전송하고 해당 모델로 작업을 수행합니다.
Kimi API 사용의 이점
Kimi를 Droid에 연결하면 CLI의 외부 모델 그 이상이 됩니다. 일상적인 개발 워크플로에 자연스럽게 녹아드는 실용적인 코딩 어시스턴트로서, 간단한 코딩 작업부터 규모가 큰 엔지니어링 작업까지 지원합니다. Kimi API 사용의 이점은 다음과 같습니다.
개발 효율 향상
Kimi는 작업 중 코드 생성, 로직 설명, 수정안 제안을 통해 일상적인 코딩 작업을 더 빠르게 처리하도록 도와줍니다. 따라서 간단한 개발 지원을 위해 여러 도구를 오갈 필요가 없습니다. Droid에서 Kimi를 사용하면 반복적인 프로그래밍 작업을 더 빠르게 관리할 수 있습니다.
더 신뢰할 수 있는 코드 작성
Kimi는 코드를 검토하고 잠재적인 문제를 짚어내며, 작은 실수가 더 큰 문제로 이어지기 전에 구조를 개선하도록 도와줍니다. 이러한 초기 피드백은 더 깔끔한 로직과 높은 유지보수성을 원할 때 유용합니다. 시간이 지나면서 테스트, 업데이트, 이해가 쉬운 코드를 만드는 데 도움이 될 수 있습니다.
다양한 개발 작업 처리
Kimi는 처음부터 코드를 작성하는 일에만 국한되지 않습니다. 리팩터링, 코드 문서화, 익숙하지 않은 프로젝트 이해, 다양한 작업에서의 기능 개발도 지원할 수 있습니다. 따라서 워크플로의 여러 부분을 하나의 AI 모델로 지원받고자 하는 개발자에게 유연한 선택지입니다.
API 연결 시 흔한 오류 해결하기
Droid에 외부 API 키를 연결하는 작업은 대체로 간단하지만, 작은 설정 실수로도 문제가 발생할 수 있습니다. 대부분의 문제는 Droid 자체보다는 설정 파일, 제공업체 이름, API 키 또는 모델 서버 구성에서 발생합니다. 어디를 확인해야 하는지 알면 이런 오류는 대개 쉽게 해결할 수 있습니다.
선택기에 모델이 표시되지 않음
레거시 형식을 사용하는 경우
~/.factory/settings.json또는config.json의 JSON 구문을 확인하세요.파일 감지를 통해 설정 변경 사항이 자동으로 감지됩니다.
사용자 지정 모델 구성에 필요한 모든 필드가 있는지 확인하세요.
"Invalid provider" 오류
제공업체 값이 정확히
anthropic,openai또는generic-chat-completion-api인지 확인하세요.제공업체 필드에 오탈자가 없는지, 대소문자가 올바른지 확인하세요.
인증 오류
API 키가 유효하고 사용 가능한 크레딧이 있는지 확인하세요
API 키에 해당 제공업체에 필요한 권한이 있는지 확인하세요
기본 URL이 제공업체 문서에 명시된 API 엔드포인트와 일치하는지 확인하세요
로컬 모델이 연결되지 않음
ollama serve와 같이 로컬 모델 서버가 실행 중인지 확인하세요기본 URL이 올바른지, 제공업체에서 요구하는 경우
/v1/이 포함되어 있는지 확인하세요모델이 이미 내려받아졌거나 로컬에서 사용할 수 있는지 확인하세요
속도 제한 또는 할당량 오류
제공업체의 API 속도 제한과 사용량 할당량을 확인하세요
제공업체 대시보드에서 사용량을 모니터링하여 제한에 도달했는지 확인하세요
마무리
Droid에서 사용자 지정 API를 사용하면 AI로 코드를 빌드하고 테스트하며 개선하는 방식을 더 세밀하게 제어할 수 있습니다. 설정을 마치면 필요에 맞는 모델을 중심으로 코딩 워크플로를 구성하기가 쉬워집니다. 기본 제공 옵션을 사용하든 외부 모델을 연결하든, Droid는 개발에 AI를 유연하게 도입할 수 있는 방법을 제공합니다. 사용자 지정 설정을 간단하게 시작하고 싶다면 Droid에서 Kimi를 사용해 볼 만합니다. 일상적인 코딩 작업을 더 매끄럽고 빠르게 처리하는 데 실용적인 선택이 될 수 있습니다.