복잡한 설정 없이 나만의 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" 오류
provider 값이 정확히
anthropic,openai,generic-chat-completion-api중 하나인지 확인하세요provider 필드에 맞춤법 오류나 대소문자 표기 오류가 없는지 확인하세요
인증 오류
API 키가 유효한지, 사용 가능한 크레딧이 남아 있는지 확인하세요
API 키가 해당 제공업체에 필요한 권한을 가지고 있는지 확인하세요
기본 URL이 제공업체 문서에 명시된 API 엔드포인트와 일치하는지 확인하세요
로컬 모델이 연결되지 않는 경우
ollama serve와 같이 로컬 모델 서버가 실행 중인지 확인하세요기본 URL이 올바른지, 제공업체가 요구하는 경우
/v1/가 포함되어 있는지 확인하세요모델을 이미 받아왔는지, 로컬에서 사용할 수 있는 상태인지 확인하세요
속도 제한 또는 할당량 오류
사용 중인 제공업체의 API 속도 제한과 사용 할당량을 확인하세요
제공업체 대시보드에서 사용량을 확인하여 한도에 도달했는지 확인하세요
결론
Droid에서 커스텀 API를 사용하면 AI로 코드를 작성, 테스트, 개선하는 방식을 더 세밀하게 제어할 수 있습니다. 설정을 마치고 나면 자신에게 맞는 모델을 중심으로 코딩 워크플로를 구성하기가 훨씬 쉬워집니다. 기본 제공 옵션을 그대로 사용하든 외부 모델을 연결하든, Droid는 AI를 개발 과정에 유연하게 도입할 수 있는 방법을 제공합니다. 커스텀 설정을 간단하게 시작해 보고 싶다면 Droid에서 Kimi를 사용해 보는 것도 좋은 방법입니다. 일상적인 코딩 작업을 더 매끄럽고 빠르게 만드는 데 실질적인 선택이 될 수 있습니다.