Aider 비용: 무료 클라이언트와 실제로 내는 API 요금

터미널에서 쓰는 오픈소스 AI 페어 프로그래밍 도구 Aider는 본체 비용이 0원입니다. Apache-2.0 소프트웨어이고 aider.chat에는 요금제도, 등급도, 좌석도, 호스팅 서비스도 없습니다. 그래서 ‘Aider 비용’은 사실상 Aider를 통해 호출하는 모델 API 요금입니다. 예산을 잡을 때 볼 숫자는 세션당 토큰 수 × 공급자 단가이고, 이 숫자를 가장 쉽게 부풀리는 것은 Aider가 모르는 모델 ID에 적용하는 기본 설정입니다. 두 줄이면 고칠 수 있으니 아래에서 차례로 설명합니다.

먼저 하나 구분해 둡니다. 검색 결과에는 회계법인용 결산 소프트웨어를 파는, 이름만 같은 다른 회사 Aider도 섞여 나옵니다. 그쪽이 공개한 월 요금은 그 제품의 것이고 이 CLI와는 관계가 없습니다. 이 페이지는 aider.chat의 CLI, 즉 Aider-AI/aider 저장소에서 aider-chat 패키지로 배포되는 도구만 다룹니다.

Aider에 내는 돈, 실제로 청구되는 돈

Aider FAQ는 이 도구를 Apache 2.0 오픈소스로 공개한다고 밝히고 있고, 홈페이지·FAQ·설치 페이지·LLM 연결 페이지 어디에도 가격이나 요금제, 구독 문구가 없습니다(2026년 10월 1일 확인). 청구는 전부 엔드포인트 건너편에서 일어납니다.

팀 표준 도구로 정하기 전에 업데이트 상황도 보세요. 저장소는 아카이브되지 않았고 스타가 49,309개지만, main의 마지막 커밋은 2026년 5월 22일입니다(GitHub API, 2026년 10월 1일). 공식 ‘최신 버전’도 두 곳이 다릅니다. PyPI는 2026년 2월 12일에 올라온 0.86.2이고, GitHub Releases는 2025년 8월 9일 v0.86.0에서 멈췄습니다. pip install로 설치되는 것은 PyPI 버전입니다. 파이썬 버전도 설치 페이지 설명보다 0.86.2 패키지 메타데이터의 >=3.10,<3.13이 pip가 실제로 적용하는 조건입니다.

API 비용을 가장 크게 움직이는 설정

가격표에는 안 보이는 부분입니다. Aider는 편집 형식, 저장소 맵(repo map), 캐시 동작을 모델 ID를 내장 표와 대조해서 정합니다. 대조에 쓰이는 것은 --model 뒤에 적은, 접두사를 포함한 문자열 전체입니다. 아무것도 일치하지 않을 때 기본값은 고급 모델 설정 페이지에 따르면 edit_format: whole, use_repo_map: false, cache_control: false, weak_model_name: null입니다.

정식 버전 0.86.2 소스에서 대조는 두 단계입니다. 먼저 gemini/gemini-3-pro-preview, openai/gpt-5.2 같은 전체 이름 313개와 정확히 비교하고, 맞는 게 없을 때만 sonnet-4-5, haiku-4-5, gpt-4.1 같은 부분 문자열 규칙으로 넘어갑니다. OpenAI 호환 게이트웨이에 연결할 때는 모델 ID를 openai/<id>로 넘기는 것이 규칙인데, 표에 있는 openai/ 접두사 항목 40개는 전부 OpenAI 자사 모델 이름입니다. 그래서 openai/claude-sonnet-4-6는 두 단계 모두 일치하지 않고, 파일 전체 다시 쓰기(whole), 저장소 맵 꺼짐 상태로 동작합니다. 모델이 수정한 파일을 매 턴 통째로 다시 출력하는데, 출력 토큰은 청구서에서 비싼 쪽입니다.

고치는 데는 두 줄이면 됩니다. Aider는 이 파일을 홈 디렉터리, git 루트, 현재 디렉터리에서 읽고, 키는 --model에 넘기는 전체 이름입니다.

# name은 --model에 넘기는 문자열과 정확히 같아야 합니다(openai/ 접두사 포함)
- name: openai/claude-sonnet-4-6
  edit_format: diff
  use_repo_map: true

한 번만 쓸 거라면 실행할 때 --edit-format diff를 붙여도 됩니다. 반대로 openai/claude-haiku-4-5는 부분 문자열 haiku-4-5에 걸려 diff와 저장소 맵이 자동으로 켜집니다. 이름이 우연히 맞은 것이라 Aider 버전마다 달라질 수 있으니, 기대지 말고 직접 확인하세요.

놓치기 쉬운 영향이 하나 더 있습니다. Aider는 메인 모델, --architect 모드의 editor 모델, 커밋 메시지와 대화 기록 요약에 쓰는 weak 모델이라는 세 역할로 API를 호출합니다(옵션 참조). ID를 인식하지 못하면 소스상 weak와 editor가 모두 메인 모델로 설정되어, 세 역할 모두 가장 비싼 단가로 청구됩니다. --weak-model로 싼 ID를 지정하면 피할 수 있습니다(여기에도 openai/ 접두사가 필요합니다).

마지막으로, 인식되지 않는 ID에서는 비용 표시도 사라집니다. input_cost_per_token이 없으면 Aider는 토큰 수만 출력하고, 경고 페이지대로 ‘모델이 무료라고 가정’합니다. 다음 메타데이터 파일로 되살릴 수 있습니다.

{
  "openai/claude-sonnet-4-6": {
    "input_cost_per_token": 0.0000021000,
    "output_cost_per_token": 0.0000105000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

메타데이터를 넣어도 Aider가 보여 주는 금액은 보고된 토큰으로 자체 계산한 값이고, 캐시 배율도 특정 공급자 값이 하드코딩되어 있습니다. 참고용으로 보고, 최종 확인은 공급자 쪽 사용 기록과 맞춰 보세요.

세션 한 번의 비용 추정

아래는 토큰 계산이지 실측한 작업 비용도, 청구 상한도 아닙니다. 세션 한 번에 캐시되지 않은 입력 200,000 토큰을 보내고 diff 편집으로 출력 12,000 토큰을 받는다고 가정합니다. whole 열은 같은 작업이 파일 전체 재출력 때문에 출력 40,000 토큰이 된다고 가정한 설명용 수치입니다(측정값이 아닙니다). 단가는 Kunavo 카탈로그의 100만 토큰당 현재 가격입니다.

이 가정에서는 편집 형식만으로 Claude Sonnet 4.6의 같은 작업이 $0.546에서 $0.840로 바뀝니다. 공급자 단가를 비교하기 전에 설정부터 고쳐야 하는 이유입니다. 커밋 메시지와 요약 트래픽(입력 30,000·출력 2,000 토큰으로 가정)도 메인 모델에 두면 Claude Sonnet 4.6 기준 $0.084, weak 모델을 Claude Haiku 4.5로 지정하면 $0.028입니다.

실제 예산으로 쓰려면 하루 세션 수를 곱하세요. Kunavo 카탈로그 금액은 청구의 하한이지 상한이 아닙니다. 상위 공급자가 비용을 보고하면 ‘카탈로그 금액’과 ‘상위 비용 × 적용 마진’ 중 큰 쪽이 청구됩니다. 캐시 요금과 외부 도구는 이 예에 포함하지 않았습니다.

‘가장 싼 API’는 두 가지 질문

Aider에는 다시 검증할 수 있는 유일한 작업 비용 기준이 있습니다. polyglot 벤치마크는 6개 언어, 225개의 Exercism 문제를 같은 조건으로 모델마다 풀게 하고 비용을 기록합니다.

리더보드 데이터 파일에서 읽은 값입니다. 순위보다 중요한 주의점이 두 가지 있습니다. 가장 최근 행이 2025년 10월 3일이라 그 뒤에 나온 모델은 여기서 한 번도 측정되지 않았습니다. 그리고 비용 열에는 가격표나 날짜가 없어서, 그날 그 실행에 든 비용일 뿐 오늘 살 수 있는 단가가 아닙니다. 여기 나온 모델은 벤치마크 근거로 이름을 든 것이며, DeepSeek은 Kunavo 카탈로그에 없습니다. 위 추정표에서 저가 쪽에 해당하는 것은 Claude Haiku 4.5입니다.

쓸 수 있는 결론은 이렇습니다. o3-pro는 gpt-5(high)의 다섯 배를 쓰고 점수는 더 낮았으니, 높은 단가가 완료를 사 주지 않습니다. 낮은 단가도 최소 총액을 보장하지 않습니다. 세 번 다시 시도하는 싼 모델이 한 번에 끝내는 비싼 모델보다 비쌀 수 있습니다. 검토 부담을 받아들일 수 있는 선에서 일을 끝내는 가장 싼 모델을 후보로 고르고, 그 작업에 대해 계정에 실제로 기록된 금액으로 확인하세요. Aider의 /tokens는 명령어 참조의 정의대로 현재 대화 컨텍스트의 토큰 수이지, 지금까지 청구된 합계가 아닙니다.

경로별로 맞는 경우

게이트웨이 경로의 경계 두 가지. Aider 전용 모듈이 없는 게이트웨이는 OpenAI 호환 API 페이지대로 OPENAI_API_BASE, OPENAI_API_KEY, 그리고 모델 ID의 필수 openai/ 접두사로 연결합니다. Anthropic 형식의 기본 URL을 바꾸는 설정은 문서에 없고, 0.86.2 소스에도 ANTHROPIC_API_BASE라는 문자열이 없습니다. 이 경로에서 프롬프트 캐시 할인도 기대하지 마세요. 캐시 페이지는 대상 공급자를 한정하고, --cache-prompts를 명시적으로 켜야 하며, 스트리밍 중에는 캐시 통계와 비용을 볼 수 없다고 적고 있습니다. 호환 경로에서 캐시가 살아 있는지는 이 페이지에서 시험하지 않았습니다.

Kunavo로 쓸 때와 한국에서 결제하는 방법

Kunavo에는 이 클라이언트용 설정 가이드가 있습니다. 다만 공개된 설정 참고 자료일 뿐 호환성 테스트는 아닙니다. Aider를 Kunavo 엔드포인트에 실제로 돌려 본 검증은 하지 않았고, 이 페이지 내용은 모두 Aider 정식 버전 소스와 공식 문서에서 읽은 것입니다. 지금 쓰는 경로는 그대로 두고, 범위가 정해진 작업 하나를 돌린 뒤 계정에 기록된 금액을 확인하세요.

결제는 선불 충전이고 월정액은 없습니다. 최소 충전액은 $10로, 작업 요금도 구독도 아닌 잔액을 만들기 위한 최소 금액입니다. 결제는 Stripe 체크아웃이며 한국에서는 카드(Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Link를 쓸 수 있습니다. 카카오페이·네이버페이 같은 국내 간편결제는 현재 결제 수단에 없습니다. 자세한 내용은 결제 안내를 보고, 준비가 되면 계정을 만드세요. 더 자세한 영어 원문은 Aider pricing입니다.

FAQ

Aider 저장소, 패키지, 문서, 리더보드 데이터는 2026년 10월 1일에 확인했고, 동작 설명은 정식 릴리스 태그 v0.86.2의 소스를 기준으로 합니다. Kunavo 단가는 실시간 카탈로그에서 가져오며, 이 페이지의 금액 예시는 모두 설명용 토큰 계산으로 실측한 작업 비용이 아닙니다.