무료 API로 쓰는 Cline, Roo Code, Kilo Code
Cline, Roo Code, Kilo Code는 VS Code용 코딩 에이전트입니다. 각각 OpenAI 호환 API를 사용할 수 있습니다. 이 가이드는 이들을 FreeLLMAPI를 통한 무료 모델에 연결합니다. 또한 이 에이전트가 보내는 길고 도구 사용이 많은 프롬프트를 처리하는 무료 모델도 보여 줍니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
시작하기 전에
FreeLLMAPI는 사용자 컴퓨터에서 실행되는 오픈 소스 게이트웨이입니다. 45개 제공업체의 무료 요금제를 하나의 키 뒤에 묶습니다. Docker에 설치한 다음, Keys 페이지에서 무료 제공업체 키를 두 개 이상 추가하세요.
macOS 또는 Linux에 설치
curl -fsSL https://freellmapi.co/install.sh | bashKeys 페이지에서 통합 키를 복사하세요. 세 에이전트 모두 같은 값을 사용합니다.
| 필드 | 값 |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API 키 | <unified-key> |
| 모델 ID | auto, 또는 GET /v1/models의 카탈로그 ID |
Cline
가장 빠른 방법은 설정 명령입니다. 이 명령은 실시간 카탈로그를 읽고, 기존 Cline 설정을 백업한 다음, OpenAI Compatible 제공업체를 추가합니다.
명령 한 줄
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>첫 번째 줄은 변경 사항을 보여 주고 아무것도 쓰지 않습니다. 두 번째 줄이 변경 사항을 씁니다. Cline을 수동으로 설정하려면 다음 단계를 따르세요.
- VS Code에서 Cline 패널을 여세요. 설정(톱니바퀴) 아이콘을 클릭하세요.
- API Provider를 OpenAI Compatible로 설정하세요.
- Base URL을
http://localhost:3001/v1로 설정하세요. - API Key를 통합 키로 설정하세요.
- Model ID를
auto로 설정하거나 아래 표의 모델로 설정하세요. - Model Configuration을 여세요. Context Window를 모델의 컨텍스트 값으로 설정하세요. Image Support는 비전 모델일 때만 켜세요.
Cline은 OpenAI Compatible 제공업체에 대해 다음 안내를 표시합니다. "Cline은 복잡한 프롬프트를 사용하므로, 모델에 따라 동작이 다를 수 있습니다." 작은 모델에는 Cline 문서가 Cline Settings, Features에서 Use Compact Prompt를 권장합니다.
Kilo Code
설정 명령을 실행하세요. 이 명령은 openai-compatible 제공업체가 있는 전역 Kilo 설정을 쓰고, 이를 기본 모델로 지정합니다.
명령 한 줄
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"설정은 키를 {env:FREELLMAPI_API_KEY}로 참조하므로, Kilo를 시작하기 전에 이 변수를 내보내세요. Kilo는 {env:...}를 신뢰된 설정에서만 확장합니다. 예를 들어 전역 폴더 ~/.config/kilo가 그런 설정입니다. 프로젝트 설정에서는 이를 무시하고 경고를 기록합니다. 생성된 설정은 다음 형태입니다.
Kilo 전역 설정 (형태)
{
"$schema": "https://app.kilo.ai/config.json",
"model": "openai-compatible/auto",
"provider": {
"openai-compatible": {
"options": {
"apiKey": "{env:FREELLMAPI_API_KEY}",
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"tool_call": true,
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}VS Code 확장 프로그램에서는 제공업체를 수동으로 추가할 수도 있습니다. Settings를 열고 Providers 탭을 연 다음 Custom provider를 클릭하세요. Provider API를 OpenAI Compatible로 설정하세요. Base URL과 키를 입력한 다음 Fetch models를 클릭하여 모델 목록을 읽으세요.
Roo Code (기존 설치)
설정 명령은 VS Code 확장 프로그램용 가져오기 파일을 씁니다. 또한 Roo CLI용 프로필도 씁니다.
명령 한 줄
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>그런 다음 Roo Code에 가져오기 파일을 불러오라고 지시하세요. VS Code settings.json에 이 줄을 추가하고 창을 다시 불러오세요. freellmapi 프로필이 현재 프로필이 됩니다.
VS Code settings.json
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"수동으로 설정하려면 Roo Code 설정을 열고 API Provider를 OpenAI Compatible로 설정하세요. Base URL, 키, 모델을 입력하세요. Roo Code는 기본 도구 호출만 사용합니다. Roo Code 문서에 따르면 기본 도구 호출을 지원하지 않는 모델은 Roo Code와 함께 쓸 수 없습니다.
에이전트 작업에 맞는 모델 고르기
이 에이전트들은 요청마다 큰 시스템 프롬프트, 도구 정의, 파일 내용을 보냅니다. 도구 호출을 지원하고 컨텍스트 창이 큰 모델을 사용하세요. 표는 오늘 기준으로 도구 호출을 지원하고 컨텍스트가 최소 128K인 무료 모델을 지능 순으로 보여 줍니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 요청/분 1 req/min per model | 예 | 아니요 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 요청/분 50 요청/일 Shared rate limit | 예 | 아니요 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | 예 | 예 |
일치하는 무료 모델 109개 중 12개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
auto를 쓰면 라우터가 요청마다 모델을 선택합니다. 한 제공업체가 429 오류를 보내면, 라우터는 다음 모델을 시도합니다.- 계획 수립과 어려운 버그에는
auto:smart를 쓰세요. - 에이전트의 컨텍스트 창을 모델의 실제 컨텍스트로 설정하세요. 값이 너무 크면, 에이전트가 모델이 거부하는 프롬프트를 보냅니다.
- 컨텍스트가 커지면 새 작업을 시작하세요. 컨텍스트가 작을수록 요청당 토큰을 적게 씁니다.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| "Invalid API Key" | 키가 FreeLLMAPI 통합 키가 아님 | Keys 페이지에서 통합 키를 다시 복사하세요 |
| "Model Not Found" | 모델 ID가 카탈로그에 없음 | auto 또는 GET /v1/models의 ID를 사용하세요 |
| 에이전트가 한 단계 후 멈추거나 도구 호출이 실패함 | 모델의 도구 호출 지원이 약하거나 없음 | 위 표에서 모델을 고르세요 |
| 긴 작업에서 컨텍스트 창 오류 발생 | 컨텍스트 설정이 모델의 실제 컨텍스트보다 큼 | 올바른 컨텍스트 창을 설정하거나 새 작업을 시작하세요 |
| "N번 시도 후 모든 모델이 요청 한도에 걸림" | 체인의 모든 키가 한도에 도달함 | 더 많은 제공업체의 키를 추가하거나 쿨다운이 끝날 때까지 기다리세요 |
Kilo: Model not found: openai-compatible/auto | 기본 모델이 제공업체의 모델 맵에 없음 | setup-kilo를 다시 실행하세요. 그러면 기본 모델이 맨 앞에 놓입니다 |
자주 묻는 질문
Cline을 무료로 쓸 수 있나요?
예. Cline은 무료이며 오픈 소스입니다. API 제공업체를 OpenAI Compatible로 설정하고 FreeLLMAPI를 가리키세요. 게이트웨이는 각 요청을 무료 제공업체 요금제로 보내므로, 추론 비용은 $0입니다.
Cline에 가장 좋은 무료 모델은 무엇인가요?
도구 호출을 지원하고 컨텍스트가 최소 128K인 모델을 쓰세요. Cline은 도구 정의가 포함된 복잡한 프롬프트를 보냅니다. 이 페이지의 표는 오늘 두 조건을 모두 충족하는 가장 성능 좋은 무료 모델을 보여 줍니다.
Roo Code는 아직 유지 관리되나요?
아니요. Roo Code README에 따르면 이 확장 프로그램은 2026년 5월 15일에 종료되었고, 저장소는 보관 처리되었습니다. 기존 설치는 OpenAI Compatible 제공업체로 여전히 동작합니다.
사용자 지정 OpenAI 호환 API로 Kilo Code를 어떻게 쓰나요?
전역 Kilo 설정에 baseURL과 apiKey를 가진 openai-compatible 제공업체를 추가하거나, npx freellmapi setup-kilo를 실행하세요. VS Code 확장 프로그램에서는 Settings, Providers, Custom provider를 사용하세요.
무료 모델로 Cline이 실패하는 이유는 무엇인가요?
대부분의 실패는 도구 호출이 약하거나 컨텍스트 창이 작은 모델에서 발생합니다. 도구 호출을 지원하고 컨텍스트가 128K인 모델을 고르고, 작은 모델에는 Use Compact Prompt를 켜세요.
관련 가이드
- VS Code의 무료 AI 모델
- 무료 LLM API로 Continue 사용하기
- 최고의 무료 코딩 모델 API
- 함수 호출을 지원하는 무료 LLM API
- Claude Code를 무료로 사용하는 방법
출처
- Cline docs: OpenAI Compatible provider (20 November 2026 확인)
- Cline docs: running models locally (20 November 2026 확인)
- Kilo docs: custom models (20 November 2026 확인)
- Kilo docs: OpenAI Compatible provider (20 November 2026 확인)
- Roo Code repository (archived) (20 November 2026 확인)
- Roo Code docs: settings management (20 November 2026 확인)
- FreeLLMAPI docs: clients and coding agents (20 November 2026 확인)