무료 LLM API로 Aider 사용하기
Aider는 터미널용 오픈소스 페어 프로그래머입니다. git 저장소의 파일을 편집하고 커밋을 만듭니다. 이 가이드는 Aider를 FreeLLMAPI를 통해 무료 모델에 연결합니다. 또한 무료 모델에 중요한 Aider 설정도 보여 줍니다. 편집 형식, 약한 모델, 저장소 맵 크기입니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
1단계: FreeLLMAPI 설치
FreeLLMAPI는 오픈소스 게이트웨이입니다. Docker에서 사용자의 컴퓨터에 실행됩니다. 45개 제공업체의 무료 티어를 OpenAI 호환 키 하나 뒤에 묶습니다.
macOS 또는 Linux에 설치
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001을 여세요. Keys 페이지에서 무료 제공업체 키를 두 개 이상 추가하세요. 같은 페이지에서 통합 키를 복사하세요.
2단계: Aider 연결
설정 명령은 ~/.aider.conf.yml을 씁니다. 먼저 기존 파일의 백업을 만듭니다.
명령 한 줄
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aider명령이 쓰는 파일은 다음과 같습니다:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"openai/ 접두사는 필수입니다. Aider에게 모델 이름을 OpenAI 호환 API로 보내라고 알려 줍니다. 파일 없이 환경 변수만 사용하려면 다음을 하세요:
환경 변수만 사용
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider는 홈 디렉터리의 .aider.conf.yml, 그다음 git 저장소의 루트, 그다음 현재 디렉터리에서 이 파일을 찾습니다. 나중에 불러온 파일이 우선합니다. 따라서 프로젝트 파일은 한 저장소의 모델을 바꿀 수 있습니다.
3단계: 모델 선택
Aider는 각 요청에 파일과 저장소 맵을 보냅니다. 주요 편집 루프에는 도구 호출이 필요하지 않습니다. 편집을 모델의 텍스트에서 읽기 때문입니다. 큰 컨텍스트 창과 좋은 지시 준수가 더 중요합니다. 아래 표는 오늘 컨텍스트가 최소 128K인 무료 모델을 보여 줍니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 요청/분 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | 예 | 아니요 |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1개 더 | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 요청/분 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Deepseek V4.1 Flash | APINex | 1M | 5 요청/분 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | 아니요 | 아니요 |
| 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 | 예 | 아니요 |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | 아니요 | 아니요 |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3개 더 | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
일치하는 무료 모델 184개 중 12개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
라우터가 모델을 선택하게 하려면 openai/auto를 사용하세요. 지능이 가장 높은 모델을 우선하려면 openai/auto:smart를 사용하세요. 모델 하나를 고정하려면 openai/와 GET /v1/models의 카탈로그 ID를 사용하세요.
명령줄에서 한 세션의 모델을 설정할 수도 있습니다. 이 예는 편집에 가장 강력한 모델을 사용합니다. 커밋 메시지와 채팅 기록 요약에는 빠른 모델을 사용합니다:
한 세션용 모델
aider --model openai/auto:smart --weak-model openai/auto:fast계획된 프로필을 쓰려면 FreeLLMAPI 대시보드에서 대체 체인을 만드세요. 예를 들어 coding이라는 체인입니다. 그다음 --model openai/auto:coding을 사용하세요. 알 수 없는 프로필 이름은 400 오류를 반환하므로, 요청이 알리지 않고 다른 체인으로 가지 않습니다.
무료 모델용 Aider 설정
Aider는 잘 알려진 모델의 설정을 알고 있습니다. auto 같은 게이트웨이 모델은 알려져 있지 않으므로 이 값들은 직접 설정하세요.
| 설정 | 기능 | 무료 모델의 권장 값 |
|---|---|---|
edit-format | 모델이 편집을 보내는 형식: whole, diff, diff-fenced 또는 udiff | 강한 모델에는 diff. 약한 모델에는 whole을 사용하세요. 단순하지만 토큰을 더 많이 보냅니다. |
weak-model | 커밋 메시지와 채팅 기록 요약에 사용하는 모델 | openai/auto:fast. 작은 작업이 강한 모델의 할당량을 쓰지 않습니다 |
map-tokens | 저장소 맵의 토큰 수. 0이면 끕니다. | 작은 무료 티어에서는 1024 이하 |
architect | 한 모델이 변경을 계획하고 편집기 모델이 편집을 작성합니다 | 선택 사항입니다. 요청 수가 두 배가 됩니다. |
무료 모델용 설정이 있는 ~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024게이트웨이 모델의 컨텍스트 창을 Aider에 알려 주려면 .aider.model.metadata.json 파일을 추가하세요. 키는 전체 모델 이름입니다. Aider는 설정 파일과 같은 위치에서 이 파일을 찾습니다.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}요청 한도와 대체
무료 티어에는 분당 및 일일 한도가 있습니다. FreeLLMAPI는 키마다 사용량을 셉니다. 제공업체가 429 오류를 반환하면 라우터는 요청을 체인의 다음 모델로 보냅니다. Aider는 오류를 보지 않고 계속합니다.
- 제공업체 네 곳 이상에서 키를 추가하세요. 제공업체가 많을수록 하루 요청 수가 늘어납니다.
/add로 바꾸고 싶은 파일만 추가하세요. 각 파일은 모든 요청에 포함됩니다.- 작업 사이에
/clear를 사용하여 더 짧은 채팅 기록을 보내세요. 기록이 짧으면 분당 토큰도 줄어듭니다. /drop을 사용하여 더 이상 필요 없는 파일을 제거하세요.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| "Model openai/auto: 컨텍스트 창 크기와 비용을 알 수 없어 기본값을 사용합니다." | Aider가 게이트웨이 모델을 알지 못함 | 이 경고는 대개 무해합니다. 없애려면 .aider.model.metadata.json을 추가하세요. |
| 편집이 적용되지 않음 | 모델이 편집 형식을 따르지 않음 | --edit-format whole을 사용하거나 더 강한 모델을 사용하세요 |
401 "Invalid API key" 오류 | Aider가 다른 키를 보냄. 예를 들어 다른 설정 파일의 키 | 홈 디렉터리, git 루트, 현재 디렉터리의 설정 파일을 확인하세요 |
| Aider가 api.openai.com을 호출함 | openai/ 접두사는 사용되지만 Base URL이 설정되지 않음 | openai-api-base 또는 OPENAI_API_BASE를 설정하세요 |
| N회 시도 후 "모든 모델의 요청 한도 초과" 오류 | 모든 키가 한도에 도달함 | 더 많은 제공업체의 키를 추가하거나 map-tokens를 줄이세요 |
자주 묻는 질문
Aider를 무료로 사용할 수 있나요?
네. Aider는 오픈소스입니다. openai-api-base와 openai/ 모델 접두사로 FreeLLMAPI를 가리키세요. 게이트웨이는 무료 제공업체 티어를 사용하므로 추론 비용은 $0입니다.
OpenAI 호환 API와 함께 Aider를 어떻게 사용하나요?
OPENAI_API_BASE와 OPENAI_API_KEY를 설정한 다음 aider --model openai/
무료 모델에는 어떤 편집 형식을 사용해야 하나요?
강한 모델에는 diff를 사용하세요. 토큰을 더 적게 보내기 때문입니다. 편집이 적용되지 않으면 whole을 사용하세요. 약한 모델에는 단순하지만 매번 전체 파일을 보냅니다.
'컨텍스트 창 크기와 비용을 알 수 없어 기본값을 사용합니다'라는 경고는 무엇을 뜻하나요?
Aider가 모델 이름을 알지 못하므로 기본값을 사용합니다. 이 경고는 대개 무해합니다. 제거하려면 컨텍스트 창이 들어 있는 .aider.model.metadata.json을 추가하세요.
Aider에 가장 좋은 무료 모델은 무엇인가요?
컨텍스트 창이 크고 지시를 잘 따르는 모델을 사용하세요. 이 페이지의 표는 오늘 컨텍스트가 128K 이상인 가장 강력한 무료 모델을 보여 줍니다.
관련 가이드
- 무료 LLM API로 OpenCode 사용하기
- 무료 모델로 Codex CLI 사용하기
- 최고의 무료 코딩 모델 API
- 무료 OpenAI 호환 API Base URL
- 100만 토큰 컨텍스트를 갖춘 무료 LLM API
출처
- Aider docs: OpenAI-compatible APIs (20 November 2026 확인)
- Aider docs: YAML config file (20 November 2026 확인)
- Aider docs: options reference (20 November 2026 확인)
- Aider docs: edit formats (20 November 2026 확인)
- Aider docs: model warnings (20 November 2026 확인)
- Aider docs: advanced model settings (20 November 2026 확인)
- FreeLLMAPI CLI generators (20 November 2026 확인)