블로그로 돌아가기

도구 및 통합가이드

Aider를 CheapTokens에 연결하는 방법

환경 변수 두 개와 openai/ 모델 접두사로 Aider를 CheapTokens OpenAI 호환 API에 연결하고, 응답이 오는지 확인하세요.

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

CheapTokens API에 연결된 터미널의 Aider
이 페이지의 내용
  1. 시작하기 전에
  2. 1단계. API 주소와 키 설정
  3. 2단계. 모델과 함께 Aider 실행
  4. 3단계. 동작 확인
  5. 자주 발생하는 오류

Aider는 터미널에서 동작하고 편집 내용을 git에 커밋하는 AI 페어 프로그래머입니다. OpenAI 호환 API라면 무엇이든 연결할 수 있으므로, CheapTokens에 연결하는 데는 환경 변수 두 개와 모델 이름 하나면 충분합니다. 이 단계는 2026년 10월 기준 Aider의 OpenAI 호환 API 문서를 따릅니다. 실제 Aider 설치 환경에서 실행해 검증한 것은 아직 아닙니다.

시작하기 전에#

  • Aider가 설치되어 있어야 합니다(aider --version가 버전을 출력).
  • CheapTokens API 키와 잔액이 있어야 합니다. 없다면 첫 API 요청부터 시작하세요.

1단계. API 주소와 키 설정#

bash
export OPENAI_API_BASE="https://api.cheaptokens.dev/v1"
export OPENAI_API_KEY="your-cheaptokens-key"

주소는 반드시 /v1로 끝나야 합니다. 매번 입력하기 번거롭다면 두 줄을 셸 프로필이나 프로젝트의 .env 파일에 넣어 두세요.

2단계. 모델과 함께 Aider 실행#

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

openai/ 접두사는 Aider에게 OpenAI 호환 프로토콜을 쓰라고 알려 주는 역할을 합니다. 요청을 보내기 전에 제거되며, API는 전체 모델 ID를 받습니다. 다른 모델:

  • openai/zai-org/GLM-5.3-Flash — 답변 전에 추론하며, 더 어려운 변경에 적합합니다.
  • openai/MiniMaxAI/MiniMax-M2.7 — 긴 에이전트 세션용이며, 200K 컨텍스트를 지원합니다.

차이점과 비용은 GLM vs DeepSeek vs MiniMax를 참고하세요.

Aider가 모델의 컨텍스트 윈도우와 가격을 알지 못한다는 경고를 표시할 수 있습니다. 이 경우 안전한 기본값을 사용하며 요청은 정상적으로 동작합니다. 각 모델의 한도는 Cline 연결하기에 정리되어 있습니다.

3단계. 동작 확인#

채팅에서 /ask what does this repository do?처럼 간단한 질문을 던져 보세요. 답변이 오면 설정이 끝난 것입니다. 아키텍트 모드, 저장소 맵, git 커밋은 로컬 머신에서 실행되므로 동일하게 동작합니다.

자주 발생하는 오류#

  • 401 — 키에 오타가 있거나 교체되었습니다. 다시 export하세요.
  • 404 — OPENAI_API_BASE가 /v1로 끝나지 않습니다.
  • 400 Model "…" not found — openai/ 뒤의 모델 ID에 오타가 있습니다.
  • 402 — 잔액이 소진되었습니다.

전체 코드: 연결 오류와 해결 방법. Aider는 매 턴마다 대화를 다시 전송하므로 청구 금액의 대부분은 입력 토큰입니다. 자세한 내용은 AI 에이전트 비용을 참고하세요.

다른 개발자에게 CheapTokens를 추천하시나요? 추천 프로그램에서는 그들의 충전액 중 일정 비율을 받습니다.