게이트웨이를 통해 Claude와 함께 사용하는 Aider: ANTHROPIC_API_BASE, 구성 파일, architect 모드 및 문제 해결
Aider는 모든 모델 호출을 LiteLLM을 통해 전송하므로, 게이트웨이를 지정하는 것은 Aider가 아닌 LiteLLM의 설정입니다. Claude의 경우 다음을 사용합니다 ANTHROPIC_API_BASE 을 게이트웨이의 호스트 루트로 설정하고, 모델 이름에는 다음을 사용합니다 anthropic/ 접두사입니다. 덜 알려진 두 가지 설정도 그만큼 중요합니다. 최신 Claude ID에는 모델 설정 항목이 필요하며, 그렇지 않으면 Aider는 저장소 맵 없이 전체 파일을 편집하는 방식으로 전환합니다.
Aider 설치
python -m pip install aider-install
aider-install
# or the one-line installer (installs Python 3.12 if needed)
curl -LsSf https://aider.chat/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"다음 명령이 aider 설치 후에도 인식되지 않는다면(Windows에서 흔히 발생하는 경우), python -m aider 으로 같은 프로그램을 실행할 수 있습니다.
게이트웨이를 통해 Claude에 연결하기
export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io
aider --model anthropic/claude-sonnet-5setx ANTHROPIC_API_KEY your_gateway_key
setx ANTHROPIC_API_BASE https://aiprimetech.io
# open a new terminal, then:
aider --model anthropic/claude-sonnet-5/v1 또한 끝에 슬래시를 붙이지 마세요. LiteLLM은 다음을 덧붙입니다 /v1/messages 자체적으로 추가하므로 https://aiprimetech.io/v1 은 다음으로 바뀝니다 /v1/v1/messages 그리고 404를 반환하며, 끝에 슬래시를 붙이면 경로에 슬래시가 두 개 연속으로 들어갑니다.Aider 자체 문서에서는 사용자 지정 Anthropic 기본 URL을 다루지 않습니다. 이 변수는 LiteLLM이 읽으며, 먼저 다음을 확인합니다 ANTHROPIC_API_BASE 그런 다음 다음을 확인합니다 ANTHROPIC_BASE_URL, 이는 Claude Code가 사용하는 변수입니다. 둘 중 어느 것이든 작동하지만, 둘 다 설정되어 있으면 ANTHROPIC_API_BASE 이 우선합니다.
다음을 유지하세요 anthropic/ 모델 이름의 접두사입니다. 공급업체 접두사가 없으면 LiteLLM은 낯선 이름을 어디로 전송해야 할지 알 수 없어 다음 오류와 함께 실패합니다 LLM Provider NOT provided.
설정을 설정 파일에 저장하기
Aider는 다음을 읽습니다 .aider.conf.yml 및 .env 홈 디렉터리, git 저장소 루트, 현재 디렉터리 순으로 읽으며, 나중에 읽은 파일이 우선합니다. 홈 디렉터리에 있는 파일은 모든 프로젝트에 적용됩니다.
model: anthropic/claude-sonnet-5
weak-model: anthropic/claude-haiku-4-5
set-env:
- ANTHROPIC_API_BASE=https://aiprimetech.io
model-settings-file: ~/.aider.model.settings.yml
model-metadata-file: ~/.aider.model.metadata.jsonANTHROPIC_API_KEY=your_gateway_keyweak-model 은 커밋 메시지와 채팅 기록 요약을 처리하므로, 여기에 저렴한 모델을 지정하면 매 세션마다 비용을 절약할 수 있습니다. set-env 은 모델을 호출하기 전에 변수를 환경에 복사하므로, 기본 URL을 셸 프로필에 넣을 필요가 없습니다.
최신 모델에서도 diff 편집과 저장소 맵 유지하기
Aider는 모델 이름에 따라 편집 형식을 선택합니다. 다음을 포함하는 이름을 비롯해 인식하는 이름에는 sonnet-4-, opus-4- 또는 haiku-4-, 다음이 적용됩니다 diff 편집과 저장소 맵입니다. 다음과 같이 인식하지 못하는 이름은 claude-sonnet-5, 전체 파일을 다시 작성하는 방식으로 전환되고 저장소 맵이 제외됩니다. 이로 인해 편집이 느려지고 비용이 늘어납니다. 설정 항목을 추가하면 올바른 동작을 복원할 수 있습니다:
- name: anthropic/claude-sonnet-5
edit_format: diff
use_repo_map: true
weak_model_name: anthropic/claude-haiku-4-5
- name: anthropic/claude-opus-5-5
edit_format: diff
use_repo_map: true
weak_model_name: anthropic/claude-haiku-4-5
editor_model_name: anthropic/claude-sonnet-5
editor_edit_format: editor-diff알 수 없는 모델은 다음 경고도 발생시킵니다: Unknown context window size and costs, using sane defaults. 이 경고 자체는 무해하지만, Aider는 이 경우 컨텍스트 창이 무제한이고 가격은 무료라고 가정합니다. 메타데이터 파일을 통해 실제 수치를 제공할 수 있습니다:
{
"anthropic/claude-sonnet-5": {
"max_tokens": 64000,
"max_input_tokens": 200000,
"max_output_tokens": 64000,
"input_cost_per_token": 0.000002,
"output_cost_per_token": 0.00001,
"litellm_provider": "anthropic",
"mode": "chat"
},
"anthropic/claude-opus-5-5": {
"max_tokens": 64000,
"max_input_tokens": 200000,
"max_output_tokens": 64000,
"input_cost_per_token": 0.000004,
"output_cost_per_token": 0.00002,
"litellm_provider": "anthropic",
"mode": "chat"
}
}가격은 Anthropic의 토큰당 정가이므로 Aider의 비용 표시에는 정가 기준 비용이 표시되며, 게이트웨이는 그보다 적은 금액을 청구합니다. 모델이 더 많은 입력을 지원하더라도 200K 입력 한도는 안전한 작업 상한선입니다.
아키텍트 모드: 한 모델로 계획하고 다른 모델로 편집하기
aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5아키텍트 모드에서는 주 모델이 변경 사항을 제안하고 편집 모델이 이를 파일 편집으로 변환합니다. 계획에는 더 강력한 모델을, 편집에는 더 저렴한 모델을 사용하면 일반적으로 두 작업 모두에 강력한 모델을 사용하는 것보다 비용이 적게 듭니다. 세션 내에서, /architect 한 메시지에 대해 해당 모델로 전환하고 /chat-mode architect 세션의 나머지 동안 해당 모델로 전환합니다.
OpenAI 호환 경로
게이트웨이는 OpenAI Chat Completions 형식도 지원하며, 이는 같은 계정에서 GPT 모델을 사용하는 경로입니다. 이 경로에서는 기본 URL에 다음이 포함됩니다: /v1, 그리고 모델 이름에는 다음 openai/ 접두사를 붙입니다:
export OPENAI_API_KEY=your_gateway_key
export OPENAI_API_BASE=https://aiprimetech.io/v1
aider --model openai/claude-sonnet-5Claude에는 위의 네이티브 경로를 권장합니다. 모델 메타데이터와 프롬프트 캐싱이 Anthropic의 형식에 맞게 작동합니다. 환경에 의도치 않게 다음이 설정되어 있으면: OPENAI_BASE_URL LiteLLM은 다음보다 이를 우선 사용합니다: OPENAI_API_BASE.
모델
| 모델 ID | 권장 용도 |
|---|---|
claude-sonnet-5 | 코딩과 에이전트 작업의 기본 선택: 빠르고 성능이 뛰어나며 가격은 중간 수준입니다. |
claude-opus-5-5 | 더 어려운 추론, 대규모 리팩터링, 장시간 에이전트 실행. |
claude-fable-5-1 | 성능이 가장 뛰어나고 가격도 가장 높습니다. 가장 어려운 작업에 사용하세요. |
claude-haiku-4-5 | 저렴하고 빠름: 제목, 요약, 분류, 간단한 단계. |
Aider의 짧은 별칭(sonnet, opus, haiku)은 이전 모델 ID를 가리키므로 모델 이름을 명시적으로 지정하세요. 다음과 같이 날짜가 포함된 오래된 ID는 claude-3-5-sonnet-20241022 제공되지 않습니다.
문제 해결
| 표시되는 내용 | 원인 | 해결 방법 |
|---|---|---|
404 / NotFoundError | /v1 에서 ANTHROPIC_API_BASE, 따라서 경로는 다음과 같이 됩니다: /v1/v1/messages | 호스트 루트를 설정하세요: https://aiprimetech.io, 끝에 슬래시를 붙이지 마세요 |
LLM Provider NOT provided | 공급자 접두사가 없는 모델 이름 | 다음을 사용하세요: anthropic/claude-sonnet-5 |
AuthenticationError: 인증할 수 없음 | Aider가 실행되는 셸에 키가 없거나 다른 엔드포인트용 키를 사용함 | echo $ANTHROPIC_API_KEY; Windows에서는 다음 작업 후 새 터미널을 여세요: setx |
| 파일 전체를 다시 작성하며 저장소 맵을 사용하지 않음 | Aider가 모델 이름을 인식하지 못함 | 위의 .aider.model.settings.yml 항목을 추가하세요 |
Unknown context window size and costs | 모델 메타데이터가 없음 | 메타데이터 파일을 추가하거나 경고를 무시하세요 |
| 토큰 한도 오류 | 채팅에 파일이 너무 많거나 파일 크기가 너무 큼 | /tokens 사용량을 확인하고, /drop 파일을, /clear 기록을 |
RateLimitError | 동시 요청 한도 또는 요청 속도 한도에 도달함 | Aider는 대기 시간을 늘리며 재시도합니다. 하나의 키로 여러 세션을 실행하지 마세요 |
| 지원되지 않는 모델 | 오래되었거나 철자가 잘못된 모델 ID | 위 표의 ID를 사용하세요 |
Aider가 아닌 모델 측에서 발생하는 오류는 다음을 참조하세요: Claude API 오류 가이드.
자주 묻는 질문
사용자 지정 Anthropic 기본 URL로 Aider를 사용하려면 어떻게 해야 하나요?
Aider는 ANTHROPIC_BASE_URL을 읽나요?
새 Claude 모델을 사용하면 Aider가 파일 전체를 다시 작성하는 이유는 무엇인가요?
Aider에서 OpenAI 호환 엔드포인트를 사용할 수 있나요?
API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.
API 키 발급받기AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.