코딩 에이전트는 턴마다 저장소의 상당 부분을 다시 보내므로, 토큰 단위로 과금되면 비용이 빠르게 불어납니다. 무제한 플랜 세션을 쓰면 이 계량이 사라집니다. 아래 단계는 Aider의 OpenAI 호환 설정 문서를 따릅니다.
1. Aider 설치
python -m pip install aider-install
aider-install
2. BroadNet Inference로 연결
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'
Windows에서는 setx OPENAI_API_BASE https://inference.broadnet.ai/v1 명령과 setx OPENAI_API_KEY your-key 명령을 실행한 뒤 새 터미널을 여세요. Aider 문서도 setx 후에는 셸을 다시 시작하라고 안내합니다.
Base URL 끝의 /v1은 그대로 두세요. chat completions 경로는 Aider가 직접 붙입니다.
3. 코드베이스에서 실행
cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash
openai/ 접두사는 Aider에 OpenAI 호환 엔드포인트를 쓰라고 알려 주고, 나머지 부분이 BroadNet의 모델 ID입니다. Aider는 “Unknown context window size and costs, using sane defaults.”(번역: 컨텍스트 윈도우 크기와 비용을 알 수 없어 합리적인 기본값을 사용합니다.)라는 경고를 띄웁니다. 내장 목록에 없는 모델이라면 예상된 동작입니다. Aider의 모델 경고 페이지는 이 경고를 대개 무시해도 된다고 설명합니다.
4. 선택 사항: Aider에 모델 정보 알려 주기
경고를 없애고 모델이 추론할 여유를 주려면 홈 디렉터리나 저장소 루트에 파일 두 개를 추가하세요. 고급 모델 설정 문서에 설명된 대로 Aider는 두 위치 중 어디에 있든 두 파일을 모두 읽습니다.
.aider.model.metadata.json:
{
"openai/broadnet/deepseek-v4.1-flash": {
"max_input_tokens": 1048576,
"litellm_provider": "openai",
"mode": "chat"
}
}
.aider.model.settings.yml:
- name: openai/broadnet/deepseek-v4.1-flash
edit_format: diff
extra_params:
max_tokens: 16000
Aider가 알 수 없는 모델에 쓰는 기본 편집 형식은 whole이며, 파일 전체를 다시 보냅니다. diff는 바뀐 블록만 보냅니다. 편집이 적용되지 않으면 edit_format 줄을 지워 whole로 되돌리세요.
팁
- Aider 창 하나에 세션 하나. Aider 인스턴스 두 개를 동시에 실행하려면 세션을 두 개 구매하세요. 그렇지 않으면 서로 뒤에서 대기합니다.
- 추론도 토큰을 씁니다. DeepSeek V4.1 Flash는 답하기 전에 추론하며, BroadNet은 이를
max_tokens에 포함합니다. 답변이 비어서 오는 이유를 참고하세요. - 먼저 1시간 써 보세요. Meteor 플랜은 1시간에 $1 요금이며, 실제 작업으로 판단해 보기에 충분한 시간입니다.
문제 해결
- 401 Unauthorized.
OPENAI_API_KEY가 없거나 틀렸거나 만료되었습니다. Aider를 실행하는 셸에 이 변수가 있는지 확인하세요. Windows에서는setx후 새 터미널을 여세요. - 요청이 BroadNet이 아닌 OpenAI로 감. 현재 셸에
OPENAI_API_BASE가 설정되지 않았거나, 모델 이름에openai/접두사가 빠졌습니다.echo $OPENAI_API_BASE로 확인하세요. - 모델을 찾을 수 없음.
openai/뒤의 부분은 정확히broadnet/deepseek-v4.1-flash값이어야 합니다. 플랜 키로는 DeepSeek V4.1 Flash만 쓸 수 있으며, 다른 BroadNet 모델에는 종량제 키가 필요합니다. - 빈 답변이나 중간에 끊기는 답변. 위에서처럼
.aider.model.settings.yml에서max_tokens를 늘리세요. - 편집이 적용되지 않음.
edit_format을whole로 되돌리거나, 명령줄에서--edit-format whole을 시도하세요. - 느린 응답이나 429. 플랜 세션은 한 번에 요청 하나를 처리하므로, 두 번째 Aider 창은 대기열에 들어갑니다. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 오류와 재시도를 참고하세요.
VS Code 안에서 쓰는 에이전트가 좋다면 Cline 설정 가이드를 보거나, Cline vs Roo Code vs Aider에서 세 도구를 비교해 보세요.
