홈 / 가이드 / 무료 LLM API로 Aider 사용하기

무료 LLM API로 Aider 사용하기

Aider는 터미널용 오픈소스 페어 프로그래머입니다. git 저장소의 파일을 편집하고 커밋을 만듭니다. 이 가이드는 Aider를 FreeLLMAPI를 통해 무료 모델에 연결합니다. 또한 무료 모델에 중요한 Aider 설정도 보여 줍니다. 편집 형식, 약한 모델, 저장소 맵 크기입니다.

코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.

1단계: FreeLLMAPI 설치

FreeLLMAPI는 오픈소스 게이트웨이입니다. Docker에서 사용자의 컴퓨터에 실행됩니다. 45개 제공업체의 무료 티어를 OpenAI 호환 키 하나 뒤에 묶습니다.

macOS 또는 Linux에 설치

curl -fsSL https://freellmapi.co/install.sh | bash

http://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/auto

Aider는 홈 디렉터리의 .aider.conf.yml, 그다음 git 저장소의 루트, 그다음 현재 디렉터리에서 이 파일을 찾습니다. 나중에 불러온 파일이 우선합니다. 따라서 프로젝트 파일은 한 저장소의 모델을 바꿀 수 있습니다.

3단계: 모델 선택

Aider는 각 요청에 파일과 저장소 맵을 보냅니다. 주요 편집 루프에는 도구 호출이 필요하지 않습니다. 편집을 모델의 텍스트에서 읽기 때문입니다. 큰 컨텍스트 창과 좋은 지시 준수가 더 중요합니다. 아래 표는 오늘 컨텍스트가 최소 128K인 무료 모델을 보여 줍니다.

Aider용 무료 모델: 128K 이상 컨텍스트, 지능 순
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
GLM 5.3APINex, UnoRouter1M5 요청/분
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
예아니요
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1개 더1M40 요청/분
40 RPM
예예
Gemini 3.8 FlashAPINex, Google AI Studio1M5 요청/분
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
예예
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowance예아니요
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring credit예예
Deepseek V4.1 FlashAPINex1M5 요청/분
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
아니요아니요
Gemini 3.7 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring credit예예
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예예
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 요청/분
50 요청/일
Shared rate limit
예아니요
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary reset아니요아니요
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3개 더262K30 요청/분
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를 줄이세요
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

Aider를 무료로 사용할 수 있나요?

네. Aider는 오픈소스입니다. openai-api-base와 openai/ 모델 접두사로 FreeLLMAPI를 가리키세요. 게이트웨이는 무료 제공업체 티어를 사용하므로 추론 비용은 $0입니다.

OpenAI 호환 API와 함께 Aider를 어떻게 사용하나요?

OPENAI_API_BASE와 OPENAI_API_KEY를 설정한 다음 aider --model openai/을 실행하세요. openai/ 접두사는 필수입니다. 같은 값을 .aider.conf.yml에도 넣을 수 있습니다.

무료 모델에는 어떤 편집 형식을 사용해야 하나요?

강한 모델에는 diff를 사용하세요. 토큰을 더 적게 보내기 때문입니다. 편집이 적용되지 않으면 whole을 사용하세요. 약한 모델에는 단순하지만 매번 전체 파일을 보냅니다.

'컨텍스트 창 크기와 비용을 알 수 없어 기본값을 사용합니다'라는 경고는 무엇을 뜻하나요?

Aider가 모델 이름을 알지 못하므로 기본값을 사용합니다. 이 경고는 대개 무해합니다. 제거하려면 컨텍스트 창이 들어 있는 .aider.model.metadata.json을 추가하세요.

Aider에 가장 좋은 무료 모델은 무엇인가요?

컨텍스트 창이 크고 지시를 잘 따르는 모델을 사용하세요. 이 페이지의 표는 오늘 컨텍스트가 128K 이상인 가장 강력한 무료 모델을 보여 줍니다.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기