문제 해결 · Cursor
Cursor Unable to Reach the Model Provider 원인과 해결 방법
Cursor는 HTTP 응답이 오기 전에 요청이 죽으면 모델 프로바이더에 연결할 수 없다고 보고합니다: 잘못된 base URL, 네트워크 경로, 또는 프로바이더 장애. 어느 경우인지 구분하는 방법.
표시되는 내용
We're having trouble connecting to the model provider. This might be temporary - please try again in a moment.발생 원인
- 커스텀 base URL이 전송 계층에서 잘못되었습니다 — 호스트 오타, 스킴 실수, 어디로도 해석되지 않는 URL — 그래서 HTTP 응답이 아예 도착하지 않습니다.
- 네트워크 경로가 차단되었습니다: Cursor와 엔드포인트 사이의 프록시, VPN, 방화벽이 연결을 끊습니다.
- 프로바이더 자체가 잠시 다운되었습니다. 이 경우 당신 쪽에서 바뀐 것이 없고 오류는 저절로 사라집니다.
- 프로바이더가 서비스하지 않는 뒤쪽 경로 조각과 함께 오버라이드 URL이 붙여넣어져, API 오류가 반환되기 전에 TLS 또는 HTTP 계층에서 실패합니다.
해결 방법
- 정확한 base URL을 Cursor 밖에서 curl로 테스트하세요. curl도 연결하지 못한다면 문제는 URL이나 네트워크이지 Cursor가 아닙니다.
- OpenAI base URL 오버라이드를 정확히 https://router.apitoken.sale/v1로 설정하고, API 경로는 Cursor가 스스로 붙이게 하세요.
- curl은 되는데 Cursor는 안 된다면, Cursor가 터미널은 쓰지 않는 프록시나 VPN을 경유하는지 확인하세요.
- 당신 쪽에서 바뀐 것이 없고 오류가 새로 생겼다면 몇 분 기다리세요 — 일시적인 프로바이더 장애가 정확히 이 메시지를 만듭니다.
엔드포인트 연결 가능 여부 확인
curl https://router.apitoken.sale/v1/models \
-H "Authorization: Bearer sk-pool-•••"관련 검색어
cursor unable to reach model provider
자주 묻는 질문
"unable to reach model provider"는 401이나 429와 같은 건가요?+
아니요. 이 메시지는 HTTP 응답이 전혀 도착하지 않았다는 뜻입니다. 401이나 429는 프로바이더가 응답했고 요청을 거부했다는 뜻입니다 — 다른 계층, 다른 해결책입니다.
어제는 Cursor가 됐는데 아무것도 안 바꿨는데 오늘 실패합니다 — 어떻게 하죠?+
이 패턴은 일시적 장애이거나 네트워크 경로 변화(VPN, 프록시, 캡티브 포털)입니다. 먼저 curl로 확인하세요. 이미 동작하던 설정을 다시 쓰지 마세요.
OpenAI 오버라이드에는 어떤 base URL을 넣어야 하나요?+
이 게이트웨이라면 https://router.apitoken.sale/v1입니다 — /v1까지 넣고 그 뒤에는 아무것도 붙이지 마세요. Cursor가 API 경로를 스스로 추가하므로 경로 조각이 더 붙으면 실패합니다.