Cursor

Cursor 설정에서 OpenAI API Key와 Base URL Override로 PleumRouter를 추가합니다. Cursor CLI 구독 백엔드는 여기 범위가 아닙니다.

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

설정#

Cursor Settings > Models에서 OpenAI API Key를 켜고 API Key에 plm_ 키, Override OpenAI Base URL에 https://apirouter.pleum.ai/v1 을 입력한 뒤 모델 ID를 추가합니다.

Cursor OpenAI API Key

OpenAI API Key           : plm_xxxxxxxxxxxxxxxx
Override OpenAI Base URL : https://apirouter.pleum.ai/v1
Model ID                 : 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 Found	base 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를 확인하고 대소문자까지 그대로 쓰세요.

데스크톱 앱#

Cursor는 이미 데스크톱 IDE입니다. Settings > Models에서 OpenAI API Key를 켜고 Override OpenAI Base URL은 https://apirouter.pleum.ai/v1, 키는 같은 plm_ 키를 씁니다. 파일 배선(pleum wire)은 없습니다.

비용·보안 팁#

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