본문으로 건너뛰기
PleumRouter
시작하기

Aider

Aider를 OPENAI_API_BASE 환경변수와 openai/ 모델 접두사로 PleumRouter에 연결합니다. 별도의 LiteLLM 프록시를 띄울 필요는 없습니다.

설정 예시입니다. Aider 버전에 따라 메뉴·설정 이름이 조금 다를 수 있습니다.

공통 환경변수는 코딩 에이전트 연결의 #setup을 보세요.

설치#

python -m pip install aider-install && aider-install로 설치합니다.

설정#

OPENAI_API_BASE와 OPENAI_API_KEY 환경변수를 설정합니다. 그다음 aider --model openai/<model-id>로 실행합니다.

  1. API 키 메뉴에서 plm_로 시작하는 키를 만들고 복사하세요.
  2. 터미널에서 export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx를 실행합니다. plm_xxxxxxxxxxxxxxxx 자리에 복사한 키를 넣으세요.
  3. OPENAI_API_BASE는 https://apirouter.pleum.ai/v1로, OPENAI_API_KEY는 $PLEUM_API_KEY로 설정하세요.
  4. aider --model openai/<model-id>로 실행하세요. <model-id>에는 모델 카탈로그의 ID를 넣으세요.
aider
export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx
export OPENAI_API_BASE=https://apirouter.pleum.ai/v1
export OPENAI_API_KEY=$PLEUM_API_KEY

aider --model openai/gpt-5.5

확인#

aider 입력창에 짧은 질문을 보내 응답이 오면 연결된 것입니다. 비용은 응답 헤더 X-Request-Id로 GET /v1/generation?id=…에서 조회할 수 있습니다.

작동 방식#

이 도구는 OpenAI Chat Completions 형식(/v1/chat/completions)으로 요청합니다. base URL은 https://apirouter.pleum.ai/v1이고 인증은 plm_ 키를 Authorization: Bearer로 보냅니다.

오류#

아래 표는 aider를 연결할 때 나오는 오류와 조치입니다. 스니펫의 plm_xxxxxxxxxxxxxxxx는 더미 값이므로 대시보드에서 발급한 실제 키로 바꿔 넣으세요.

증상원인조치
401 Unauthorized키가 잘못 복사됐거나 더 이상 유효하지 않습니다.API 키 메뉴에서 키를 다시 복사해 export PLEUM_API_KEY= 줄을 고치세요.
402 Payment Required크레딧 잔액이 부족하거나 이 키의 일·주·월 예산 또는 월 토큰 한도를 넘었습니다.크레딧을 충전하거나 API 키 메뉴에서 이 키의 예산과 한도를 조정하세요.
404 Not FoundOPENAI_API_BASE에 /v1이 빠졌거나 경로가 덧붙었습니다. 채팅 경로는 /v1/chat/completions입니다.OPENAI_API_BASE를 https://apirouter.pleum.ai/v1로 설정하고 주소 뒤에 경로를 붙이지 마세요.
429 Too Many Requests이 키의 요청 한도를 넘었거나 모델 공급자 쪽 요청 한도에 걸렸습니다.잠시 기다린 뒤 다시 실행하세요. 더 높은 한도가 필요하면 사용량 제한의 안내대로 문의하세요.

비용·보안 팁#

  • 키에 예산을 걸어 두세요. 코딩 에이전트는 한 작업에서 모델을 여러 번 호출하고 긴 컨텍스트를 반복해 보냅니다. API 키에 일·주·월 예산을 설정하면 비용을 예측하기 쉽습니다.
  • 키는 git에 올리지 마세요. 셸 프로필이나 설정 파일에 넣은 키가 저장소에 커밋되지 않게 하고, 유출이 의심되면 대시보드에서 바로 폐기한 뒤 새로 발급하세요.
  • 민감한 코드라면 처리 위치를 확인하세요. 프롬프트와 코드는 고른 모델의 공급자에게 전달됩니다. 데이터 처리 위치와 개인정보 마스킹으로 범위를 정할 수 있습니다.
이전Zed다음Crush