BroadRouter

Aider를 무제한 DeepSeek V4.1 Flash로 실행하기

업데이트

Aider는 OpenAI 호환 API라면 어디든 연결됩니다. OPENAI_API_BASE를 https://inference.broadnet.ai/v1로, OPENAI_API_KEY를 BroadNet 키로 설정한 뒤 aider --model openai/broadnet/deepseek-v4.1-flash로 실행하세요. openai/ 접두사는 Aider의 OpenAI 호환 경로를 선택합니다. 무제한 플랜 키에서는 DeepSeek V4.1 Flash 토큰이 계량되지 않으므로, 저장소 작업 세션이 길어져도 요금은 정액 그대로입니다.

코딩 에이전트는 턴마다 저장소의 상당 부분을 다시 보내므로, 토큰 단위로 과금되면 비용이 빠르게 불어납니다. 무제한 플랜 세션을 쓰면 이 계량이 사라집니다. 아래 단계는 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에서 세 도구를 비교해 보세요.

BroadNet Inference에서 플랜 선택하기

자주 묻는 질문

Aider를 OpenAI 호환 API와 함께 쓰려면 어떻게 하나요?

OPENAI_API_BASE에 제공업체의 Base URL을, OPENAI_API_KEY에 그 키를 설정한 뒤 --model openai/ 뒤에 제공업체의 모델 ID를 붙여 aider를 실행하세요. BroadNet이라면 모델은 openai/broadnet/deepseek-v4.1-flash, Base URL은 https://inference.broadnet.ai/v1입니다.

Aider에 "Unknown context window size and costs" 경고가 뜨는 이유는 무엇인가요?

Aider에는 BroadNet 모델 ID에 대한 메타데이터가 내장되어 있지 않아서, 컨텍스트는 무제한이고 비용은 0이라고 가정합니다. Aider 문서는 이 경고를 대개 무시해도 된다고 설명합니다. 경고를 없애려면 .aider.model.metadata.json에 모델을 추가하세요.

모델 ID가 이미 broadnet/으로 시작하는데 openai/ 접두사가 꼭 필요한가요?

네. Aider는 첫 부분을 제공자 경로로 읽습니다. openai/는 요청을 OPENAI_API_BASE로 보내고, broadnet/deepseek-v4.1-flash는 BroadNet이 받는 모델 ID입니다.

DeepSeek V4.1 Flash를 쓰는 Aider에서 답변이 비거나 중간에 끊기는 이유는 무엇인가요?

이 모델은 답하기 전에 추론하고, BroadNet은 추론도 max_tokens에 포함합니다. .aider.model.settings.yml의 extra_params로 max_tokens를 더 높게 설정하세요.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기