블로그로 돌아가기

도구 및 통합가이드

자신의 API 키를 위한 Aider 설정 파일: .aider.conf.yml과 Windows setx

자신의 API 키와 base URL을 .aider.conf.yml에 보관하고, 로드 순서를 올바르게 하며, Windows setx 함정을 피하고, 세션 비용을 추정하세요.

작성자: CheapTokens Team 게시됨읽는 시간 4분

Aider를 OpenAI 호환 API에 연결하는 명령이 있는 터미널
이 페이지의 내용
  1. Windows: setx와 새 터미널
  2. 어떤 편집에 어떤 모델을
  3. 첫 편집 실행하기
  4. 다시 입력하지 않기: .aider.conf.yml
  5. 세션 비용
  6. 작동하지 않을 때

OPENAI_API_BASE와 OPENAI_API_KEY 두 변수, 그리고 openai/<model id> 같은 모델 인자만 있으면 Aider를 CheapTokens로 연결할 수 있습니다. 단계별 기본 사항(설치, 첫 요청, 401/404/400/402)은 Aider를 CheapTokens에 연결하는 방법에 있으며, 이 페이지는 그 가이드에서 다루지 않은 내용을 설명합니다: Windows setx, 설정 파일과 그 로드 순서, 그리고 세션 비용 추정입니다.

출처: OpenAI 호환 API에 대한 Aider 문서(2026년 10월 26일 확인, 문서에는 날짜나 버전이 없으며, 그날 PyPI의 최신 aider-chat은 0.86.2였습니다).

Windows: setx와 새 터미널#

Mac과 Linux에서는 두 변수를 export합니다. Windows(PowerShell 또는 cmd)에서는 setx를 사용하세요:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Windows에는 함정이 있습니다. setx는 현재 입력 중인 세션이 아니라 이후 세션을 위해 변수를 기록하므로, Aider를 시작하기 전에 터미널을 닫고 새 터미널을 여세요. 변수를 설정했는데도 Aider가 여전히 키를 요구한다면, 이것이 일반적인 원인입니다.

어떤 편집에 어떤 모델을#

모델 인자는 openai/에 전체 id를 붙인 형태이므로, CheapTokens의 경우 슬래시가 두 개입니다:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7은 180K 컨텍스트와 최대 8,192 토큰의 응답을 제공하며, 응답이 짧게 유지되는 소규모 및 중간 규모 편집에 적합합니다. 편집 결과가 긴 diff로 돌아온다면, 시도해 볼 만한 다른 모델은 DeepSeek-V4-Flash입니다: 응답당 최대 32,768 토큰, 380K 컨텍스트, 그리고 시간대와 무관하게 동일한 가격입니다.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

전체 id는 CheapTokens 문서 또는 가격의 모델 목록에서 복사하세요.

첫 편집 실행하기#

Aider는 git 저장소 안에서 작동하므로, 저장소 안에서 시작하세요. 파일을 추가하고 작은 작업을 요청하세요:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Aider가 파일 편집으로 응답하면, 키, base URL, 모델 id가 모두 올바른 것입니다.

작동하지 않는 잘못된 모델 id 옆에 작동하는 전체 id, 그리고 첫 편집
잘못된 id 대 전체 id, 그리고 첫 요청

다시 입력하지 않기: .aider.conf.yml#

Aider는 홈 디렉터리, 그다음 git 저장소 루트, 그다음 현재 디렉터리 순으로 .aider.conf.yml를 읽으며, 뒤에 오는 파일이 우선합니다. 따라서 전역 파일에는 키와 base를 담고, 저장소 파일에서는 모델을 선택할 수 있습니다. 특정 파일 하나만 사용하고 다른 것은 사용하지 않으려면 aider --config <file>가 그것만 로드합니다.

홈 디렉터리 파일(예시, 자신의 키를 넣으세요):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

이제 aider만으로 올바른 엔드포인트와 모델로 시작합니다. 파일을 저장소에 커밋한다면 키는 빼고 환경 변수나 .env 파일에 보관하세요; 키 줄은 자신의 홈 디렉터리용입니다.

Aider가 모르는 모델의 경우, 문서에서는 설정을 지정할 수 있는 model-settings-file(.aider.model.settings.yml)를 설명합니다.

세션 비용#

Aider는 메시지를 보낼 때마다 추가한 파일과 채팅 기록을 다시 전송하므로, 입력 토큰이 출력보다 빠르게 증가합니다. 약 20개 메시지의 작업 세션이 400,000 입력 토큰을 보내고 40,000 출력 토큰을 받는다고 가정해 봅시다(예시를 위한 가정이며, 자신의 숫자를 대입하세요). MiniMax-M2.7에서는 $0.026이며, 입력과 출력을 합산할 때 총액 기준으로 OpenRouter보다 저렴합니다. 아래 표는 동일한 세션을 우리 모델들에 대해 실행한 결과입니다:

모델 비용 OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

총 입력 400,000개 및 출력 40,000개 토큰입니다. 100만 토큰당 가격은 현재 기준이며 당사 요금제에 따라 함께 변경됩니다. OpenRouter 열은 동일한 작업량에 대한 참고 가격을 보여줍니다.

입력 측을 작게 유지하는 방법(읽기 전용 파일, /drop, 저장소 맵 크기)은 Aider 비용은 얼마인가에서 다룹니다. 현재 가격은 항상 가격 페이지에 있습니다.

작동하지 않을 때#

  • Aider가 API 키를 요구하거나 잘못된 서비스와 통신합니다. 변수가 프로세스에 보이지 않는 것입니다. Windows에서는 setx 후 터미널을 재시작하세요; Mac과 Linux에서는 같은 셸에서 echo $OPENAI_API_BASE를 실행하세요.
  • 설정이 무시되는 것 같습니다. 순서를 기억하세요: 홈, 저장소 루트, 현재 디렉터리. 더 가까운 파일이 전역 파일을 덮어씁니다.
  • 모델을 찾을 수 없음, 404 또는 인증 오류. 이는 Aider를 CheapTokens에 연결하는 방법에서 다룹니다.

동일한 OpenAI 호환 주소는 다른 도구에서도 작동합니다; 에디터 에이전트도 사용한다면 OpenCode 연결 또는 자신의 API 키를 어디에 넣을지 개요를 참고하세요.

태그: