Roo Code는 강력한 오픈소스 AI 코딩 어시스턴트로, VSCode 편집기에서 직접 자율 개발 기능을 제공합니다. 130만 회 이상 설치되었으며 활발한 개발자 커뮤니티를 보유한 Roo Code는 유연성, 멀티 모델 지원, 그리고 AI 에이전트의 집중력과 생산성을 유지하는 역할별 모드에서 두각을 나타냅니다.
이 가이드에서는 Novita AI의 LLM API를 Roo Code와 통합하는 방법을 소개합니다. 이를 통해 Moonshot AI의 Kimi, DeepSeek과 같은 최첨단 모델을 경쟁력 있는 가격으로 익숙한 VSCode 환경에서 사용할 수 있습니다.
Roo Code + Novita AI를 선택해야 하는 이유
Roo Code: VSCode 속 AI 개발팀
Roo Code는 단순한 자동 완성 기능을 넘어섭니다. 에이전트 방식의 코딩 어시스턴트로서 다음과 같은 작업을 수행할 수 있습니다:
- 자연어 설명으로 코드 생성
- 여러 파일에 걸친 기존 코드베이스 리팩토링 및 디버깅
- 문서 작성 및 코드 관련 질문에 답변
- 명령 실행 및 테스트 수행 (사용자 승인 필요)
- 특화된 모드(Architect, Code, Debug, Ask, Test)로 워크플로우에 적응
Cursor나 Windsurf 같은 독점 도구와 달리 Roo Code는:
✅ 완전 오픈소스(Apache 2.0 라이선스)
✅ 모델에 구애받지 않음(OpenAI, Anthropic, Google, Novita AI 등 10개 이상의 제공업체와 호환)
✅ 프라이버시 우선(외부 API로 전송하지 않는 한 코드가 기기를 떠나지 않음)
✅ 커뮤니티 주도(GitHub 별 22.5k+, 활발한 Discord 커뮤니티)
Novita AI: 비용 효율적인 LLM 액세스
Novita AI는 개발자 친화적인 방식으로 최첨단 언어 모델에 대한 액세스를 제공합니다:
- 투명한 종량제 요금제의 경쟁력 있는 가격
- 다양한 모델 선택 (100개 이상의 모델 - DeepSeek, Moonshot AI, Qwen 등)
- OpenAI 호환 API(기존 코드에 드롭인 교체 가능)
- 낮은 지연 시간의 높은 안정성
사전 준비 사항
시작하기 전에 다음이 준비되어 있는지 확인하세요:
VSCode 설치
공식 웹사이트에서 최신 버전의 Visual Studio Code를 다운로드하세요.
Novita AI 계정 및 API 키
통합 단계
1단계: Roo Code 확장 프로그램 설치
- VSCode를 열고 확장 프로그램 패널로 이동하세요.
- 마켓플레이스에서 "Roo Code"를 검색하세요.
- Roo Veterinary Inc(ID:
RooVeterinaryInc.roo-cline)의 확장 프로그램에서 설치를 클릭하세요. - 설치 후 VSCode 사이드바에 Roo Code 아이콘(캥거루)이 나타납니다.
2단계: 타사 제공업체(Novita AI) 구성
확장 프로그램이 설치되면 Novita AI의 API에 연결해야 합니다:
- 사이드바에서 Roo Code 아이콘을 클릭하여 패널을 엽니다.
- 설정 화면에서 두 가지 옵션이 표시됩니다:
- Roo Code Router(Roo Code 계정 필요)
- 타사 제공업체(자체 API 키 사용)
- 타사 제공업체를 선택하세요.
- 구성 필드를 입력하세요:
- API 제공업체: OpenAI 호환 선택
- Base URL:
https://api.novita.ai/openai - API 키: Novita AI API 키 붙여넣기(사전 준비 2단계에서)
- 모델: 원하는 모델 이름 입력(예:
moonshotai/kimi-k2.5)
- 🎉참고: 사용 가능한 전체 모델 목록은 Novita AI 모델 페이지에서 확인할 수 있습니다.
3단계: 통합 테스트
Roo Code가 Novita AI와 통신할 수 있는지 확인해 보겠습니다:
- VSCode에서 기존 프로젝트를 열거나 새 파일을 만드세요.
- Roo Code 패널을 엽니다(캥거루 아이콘 클릭).
- 채팅 인터페이스에 간단한 요청을 입력하세요.
- AI가 응답할 때까지 기다리세요. 다음이 표시되어야 합니다:
- “Thinking” 표시기(API 요청 진행 중)
- 모델의 응답(예: “안녕하세요! 저는 Architect 모드로, 계획을 도와드릴 준비가 되었습니다…”)
Roo Code 모드 이해하기
Roo Code의 가장 강력한 기능 중 하나는 모드 시스템입니다. 모드는 AI가 특정 작업에 집중하고 도구 액세스를 관련 기능으로 제한하여 환각을 줄이고 원치 않는 변경을 방지합니다.
사용 가능한 모드
| 모드 | 목적 | 사용 시기 |
| Architect | 계획 및 설계(코드 변경 없음) | 새 기능 시작, 시스템 아키텍처 설계, 복잡한 작업 분할 |
| Code | 구현 및 리팩토링 | 새 코드 작성, 기존 파일 리팩토링, 여러 파일 편집 |
| Ask | Q&A 및 설명(읽기 전용) | 코드 작동 방식 이해, 빠른 답변 얻기, 문서 생성 |
| Debug | 진단 및 수정 | 오류 추적, 로그 추가, 근본 원인 격리 |
| Orchestrator | 여러 모드 간 작업 조정 | 작업이 여러 단계나 역할에 걸쳐 있을 때(예: 먼저 계획, 그다음 구현, 마지막으로 디버깅), 크고 복잡한 요청 처리, 큰 기능을 병렬 하위 작업으로 분할, 또는 Roo가 Architect/Code/Debug 간의 핸드오프를 자동으로 관리하도록 할 때 |
문제 해결
오류: “잘못된 API 키”
해결 방법:
- Novita AI에서 API 키를 올바르게 복사했는지 다시 확인하세요.
- 키 앞뒤에 공백이 없는지 확인하세요.
- 키가 만료되지 않았는지 확인하세요(필요시 재생성).
Roo Code가 느리거나 응답하지 않음
해결 방법:
- 인터넷 연결을 확인하세요.
- 컨텍스트의 파일 수를 줄이세요(
.rooignore를 사용하여 큰 디렉토리 제외).
결론
VSCode에서 Novita AI와 Roo Code를 성공적으로 통합했습니다! 이 강력한 조합은 유연한 AI 모델 액세스, 비용 효율적인 개발, 완전한 프라이버시 제어를 제공하며, 특정 공급업체에 종속되지 않습니다.
이제 개발을 시작할 준비가 되셨나요? Roo Code에게 복잡한 함수 리팩토링, 단위 테스트 생성, 까다로운 오류 디버깅을 요청해 보세요. 더 많은 튜토리얼과 커뮤니티 지원을 원하시면 Roo Code 문서를 방문하고 Discord 커뮤니티에 참여하세요.
즐거운 코딩 되세요! 🦘
***Novita AI*는 개발자가 간단한 API를 사용하여 AI 모델을 쉽게 배포할 수 있도록 지원하는 AI 클라우드 플랫폼이며, 구축 및 확장을 위한 저렴하고 안정적인 GPU 클라우드도 제공합니다.
자주 묻는 질문
Roo Code란 무엇인가요?
Roo Code는 VSCode용 오픈소스 AI 코딩 어시스턴트로, 편집기에 자율 개발 기능을 제공합니다. 자연어 상호작용을 통해 코드 생성, 여러 파일에 걸친 리팩토링, 문서 작성, 문제 디버깅, 명령 실행 등을 수행할 수 있습니다. 자동 완성 도구와 달리 Roo Code는 역할별 모드(Architect, Code, Debug, Ask, Test)를 갖춘 에이전트 방식의 어시스턴트로, AI가 특정 작업에 집중하도록 합니다.
Roo Code는 무료인가요?
네, Roo Code 자체는 무료이며 오픈소스입니다. 다음과 함께 사용할 수 있습니다: - Novita AI 같은 제공업체의 자체 API 키(종량제) - Roo Code Router(Roo Code의 서비스) - 로컬 모델용 Ollama(무료, 사용자 기기에서 실행)
Roo Code가 Cursor보다 더 나은가요?
Roo Code와 Cursor는 비슷한 목적을 제공하지만 각각 다른 강점이 있습니다. Roo Code는 완전 오픈소스이며 모델에 구애받지 않아 모든 AI 제공업체(OpenAI, Anthropic, Novita AI 등)를 사용할 수 있고 단일 공급업체에 종속되지 않습니다. Cursor는 더 세련되고 통합된 경험을 제공하지만 구독이 필요하고 모델 선택이 제한됩니다. 유연성, 비용 제어, 오픈소스 가치가 중요하다면 Roo Code가 더 나은 선택입니다.
