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

Crush

Crush는 crush.json의 openai-compat provider와 PLEUM_API_KEY를 사용합니다.

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

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

설정#

type을 openai-compat, base_url을 https://apirouter.pleum.ai/v1 로 둡니다.

  1. API 키 메뉴에서 plm_로 시작하는 키를 만든 뒤, 터미널에서 export PLEUM_API_KEY=plm_xxxxxxxxxxxxxxxx를 실행합니다. plm_xxxxxxxxxxxxxxxx 자리에 복사한 키를 넣으세요.
  2. 아래 JSON을 ~/.config/crush/crush.json에 저장합니다. api_key의 $PLEUM_API_KEY는 위에서 설정한 환경변수를 읽습니다.
~/.config/crush/crush.json
{
  "providers": {
    "pleum": {
      "type": "openai-compat",
      "base_url": "https://apirouter.pleum.ai/v1",
      "api_key": "$PLEUM_API_KEY",
      "models": [{ "id": "gpt-5.5", "name": "gpt-5.5" }]
    }
  }
}

확인#

짧은 프롬프트를 보내 응답이 오면 연결입니다. 비용은 응답 헤더 X-Request-Id로 GET /v1/generation?id=…에서 조회할 수 있습니다.

작동 방식#

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

오류#

스니펫의 plm_xxxxxxxxxxxxxxxx는 더미입니다. 대시보드 API 키에서 발급한 실제 키로 바꾸세요. Base URL 끝에 /chat/completions를 붙이지 마세요.

증상원인과 조치
401 Unauthorized키가 틀렸거나 비활성입니다. 대시보드 API 키에서 plm_ 키를 다시 복사하세요. 다른 서비스의 키를 넣지 않았는지도 확인하세요.
402 Payment Required크레딧 잔액이 부족하거나 키의 일·주·월 예산이나 월 토큰 한도를 다 썼습니다. 충전하거나 API 키의 예산과 한도를 확인하세요.
404 Not Foundbase URL이 틀렸거나 모델 ID가 카탈로그에 없습니다. OpenAI 호환 도구는 /v1까지, Anthropic·Gemini 도구는 /v1이 없는 루트 주소입니다. 끝에 /chat/completions 같은 경로를 직접 붙이지 마세요. 오류 코드가 model_not_found면 모델 ID를 확인하세요.
429 Too Many Requests키당 분당 요청 한도나 동시 요청 한도(concurrency_limit_exceeded)를 넘었거나, 모델 공급자 쪽 한도에 걸렸습니다(upstream_rate_limited). 에이전트의 병렬 실행 수를 줄이고 사용량 제한을 확인하세요.
model not found카탈로그에 없는 모델 ID입니다. GET /v1/models로 정확한 ID를 확인하고 대소문자까지 그대로 쓰세요.

비용·보안 팁#

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