---
title: "Aider OpenAI 호환 API 설정(무제한 DeepSeek) | BroadRouter"
description: "Aider 코딩 에이전트를 OpenAI 호환 설정으로 BroadNet Inference에 연결하고, 정액 요금의 무제한 DeepSeek V4.1 Flash 플랜으로 실행하는 방법을 설명합니다."
url: https://broadrouter.com/ko/guides/aider-unlimited-deepseek/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/aider-unlimited-deepseek/) (2026-11-16 업데이트).

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

업데이트 2026-11-16

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 토큰이 계량되지 않으므로, 저장소 작업 세션이 길어져도 요금은 정액 그대로입니다.

코딩 에이전트는 턴마다 저장소의 상당 부분을 다시 보내므로, 토큰 단위로 과금되면 비용이 빠르게 불어납니다. [무제한 플랜 세션](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)을 쓰면 이 계량이 사라집니다. 아래 단계는 [Aider의 OpenAI 호환 설정 문서](https://aider.chat/docs/llms/openai-compat.html)를 따릅니다.

## 1\. Aider 설치

```bash
python -m pip install aider-install
aider-install
```

## 2\. BroadNet Inference로 연결

```bash
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\. 코드베이스에서 실행

```bash
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의 [모델 경고 페이지](https://aider.chat/docs/llms/warnings.html)는 이 경고를 대개 무시해도 된다고 설명합니다.

## 4\. 선택 사항: Aider에 모델 정보 알려 주기

경고를 없애고 모델이 추론할 여유를 주려면 홈 디렉터리나 저장소 루트에 파일 두 개를 추가하세요. [고급 모델 설정 문서](https://aider.chat/docs/config/adv-model-settings.html)에 설명된 대로 Aider는 두 위치 중 어디에 있든 두 파일을 모두 읽습니다.

`.aider.model.metadata.json`:

```json
{
  "openai/broadnet/deepseek-v4.1-flash": {
    "max_input_tokens": 1048576,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}
```

`.aider.model.settings.yml`:

```yaml
- 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`에 포함합니다. [답변이 비어서 오는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)를 참고하세요.
-   **먼저 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 건까지 허용합니다. [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)를 참고하세요.

VS Code 안에서 쓰는 에이전트가 좋다면 [Cline 설정 가이드](https://broadrouter.com/ko/guides/cline-openai-compatible/)를 보거나, [Cline vs Roo Code vs Aider](https://broadrouter.com/ko/blog/cline-vs-roo-code-vs-aider/)에서 세 도구를 비교해 보세요.

[BroadNet Inference에서 플랜 선택하기](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-aider-unlimited-deepseek&utm_content=body)

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[컨텍스트 윈도우(context window)](https://broadrouter.com/ko/glossary/context-window/)

컨텍스트 윈도우는 언어 모델이 요청 한 번에 다룰 수 있는 최대 토큰 수입니다. 프롬프트, 대화 기록, 도구 정의, 이미지, 그리고 추론 토큰을 포함한 생성 출력이 모두 여기에 들어갑니다. 들어가지 않는 내용은 잘라 내거나 요약하거나 여러 요청으로 나눠야 합니다.

[OpenAI 호환 API(OpenAI-compatible API)](https://broadrouter.com/ko/glossary/openai-compatible-api/)

OpenAI 호환 API는 POST /v1/chat/completions처럼 OpenAI API와 같은 요청 및 응답 형식을 받는 HTTP API입니다. 그래서 OpenAI SDK와 도구는 base URL, API 키, 모델 이름만 바꾸면 이 API를 그대로 사용할 수 있습니다.

[동시 처리(concurrency)](https://broadrouter.com/ko/glossary/concurrency/)

동시 처리(concurrency)는 클라이언트가 같은 시점에 진행 중인 요청 수입니다. LLM API는 분당 요청 수와 별도로 키나 플랜마다 이를 제한하는 경우가 많습니다. 열려 있는 요청은 응답이 끝날 때까지 GPU 용량을 차지하기 때문입니다.

[속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/)

속도 제한(rate limit)은 API가 일정 시간 동안 클라이언트가 사용할 수 있는 양에 두는 상한으로, 분당 요청 수나 분당 토큰 수 같은 기준이 있습니다. 한도를 넘은 요청은 사용량이 다시 한도 아래로 내려갈 때까지 거부되며, 보통 HTTP 429 Too Many Requests가 반환됩니다.

[base URL(베이스 URL)](https://broadrouter.com/ko/glossary/base-url/)

base URL은 https://api.example.com/v1처럼 API의 고정된 루트 주소로, 클라이언트가 /chat/completions 같은 모든 엔드포인트 경로 앞에 붙입니다. OpenAI 호환 SDK에서는 base URL을 API 키, 모델 ID와 함께 바꾸면 같은 코드로 다른 제공업체를 호출할 수 있습니다.

[Chat Completions API](https://broadrouter.com/ko/glossary/chat-completions-api/)

Chat Completions API는 OpenAI의 HTTP 엔드포인트인 POST /v1/chat/completions로, 모델 이름과 역할이 붙은 메시지 목록을 받아 모델의 다음 메시지를 반환합니다. 이 요청과 응답 구조는 OpenAI 호환 제공업체와 SDK가 재사용하는 공통 형식이 되었습니다.

## 자주 묻는 질문

### 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를 더 높게 설정하세요.

## 관련 가이드

-   [에이전트용 무제한 LLM API 플랜은 어떻게 작동하나요?](https://broadrouter.com/ko/guides/unlimited-llm-api-sessions/)
-   [추론 모델이 빈 답변을 반환하는 이유](https://broadrouter.com/ko/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference에서 Cline 사용하기(OpenAI Compatible 제공자)](https://broadrouter.com/ko/guides/cline-openai-compatible/)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
-   [BroadNet Inference와 함께 쓸 수 있는 모든 도구 (영어)](https://broadrouter.com/integrations/): SDK, 코딩 에이전트, 채팅 UI, 자동화 도구와 각 도구의 정확한 설정

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-aider-unlimited-deepseek&utm_content=page-cta) ·

**출처**

-   [Aider 문서, OpenAI 호환 API(2026-11-14 확인)](https://aider.chat/docs/llms/openai-compat.html)
-   [Aider 문서, 모델 경고(2026-11-14 확인)](https://aider.chat/docs/llms/warnings.html)
-   [Aider 문서, 고급 모델 설정(2026-11-14 확인)](https://aider.chat/docs/config/adv-model-settings.html)
-   [BroadNet Inference API 레퍼런스 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-aider-unlimited-deepseek&utm_content=sources)
-   [BroadNet Inference 무제한 플랜 (영어)](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-aider-unlimited-deepseek&utm_content=sources)
