Cursor Internal error 해결법 — 원인별 체크리스트 4가지 (2026년 7월)

Cursor 채팅이나 에이전트를 쓰려는데 "Internal error — An unexpected error occurred on our servers. Please try again, or contact support if the issue persists."라는 메시지만 뜨고 아무것도 안 되는 경험, 최근 커서 포럼에 꾸준히 올라오고 있습니다. 근데 이 오류, 검색해보면 해결책이 제각각이라 더 헷갈립니다. 누군가는 설정 하나 바꾸니 됐다고 하고, 누군가는 그냥 기다리니 풀렸다고 하고요. 사실 "Internal error"라는 같은 문구 뒤에 서로 다른 원인이 섞여 있어서 그렇습니다. 이 글에서는 실제 포럼 사례를 원인별로 나눠서, 내 상황이 어디에 해당하는지 먼저 찾고 맞는 해결책으로 넘어갈 수 있게 정리했습니다.

Cursor IDE에서 Internal error 메시지가 표시된 화면

 

Cursor Internal error, 하나의 원인이 아니다

2026년 7월 한 달만 봐도 날짜마다 성격이 다른 "Internal error" 신고가 이어졌습니다. 7일에는 "[internal] Protocol error"라는 구체적 메시지와 함께 기업 방화벽 문제가 원인으로 특정된 사례가 있었고, 11일에는 원인을 특정하지 못한 채 며칠 뒤 자연스럽게 풀린 사례가, 12일에는 로컬 네트워크 단절로 판정된 사례가 각각 따로 있었습니다. 커서 공식 상태 페이지(status.cursor.com)를 확인해보면 이 기간(7월 9~12일) 동안 회사 차원에서 인정한 인시던트는 없습니다. 즉 "대규모 서버 장애"라기보다, 원인이 저마다 다른 개별 사용자 오류들이 같은 에러 문구 아래 뒤섞여 보이는 상황에 가깝습니다.

그래서 이 오류를 만났다면 "왜 나만 이래?"보다 "내 케이스는 어디에 해당하나"를 먼저 따져보는 게 빠릅니다. 아래 순서대로 하나씩 체크해보세요.

 

체크리스트 ① 기업 방화벽·프록시가 HTTP/2를 막아 Cursor 오류가 나는 경우

회사 네트워크나 Zscaler 같은 보안 프록시를 쓰는 환경이라면 이게 가장 유력한 원인입니다. Cursor는 Tab이나 Cmd K 같은 기능에서 기본적으로 HTTP/2를 쓰는데, 일부 기업 프록시가 이 프로토콜 자체를 차단하면서 연결이 중간에 끊깁니다.

실제로 2026년 7월 7일 포럼 스레드에서 사용자 amrapali.srivastava는 "최신 커서 버전이 엔터프라이즈 방화벽과 호환되지 않는다"며, HTTP 호환성을 HTTP/2에서 HTTP/1.1로 바꾸니 해결됐다고 밝혔습니다. Cursor 담당자 Kevin Neilson도 공식 답변에서 "실패는 '프로토콜 에러'로, 연결이 중단되었거나 응답이 전송 중 손상되었음을 의미한다"고 설명했고요.

해결 방법은 두 가지입니다.

• 앱 설정에서 HTTP 호환성을 HTTP/1.1로 전환하기
• Cmd+Shift+P(윈도우는 Ctrl+Shift+P) → Preferences: Open User Settings JSON을 열고 아래처럼 추가한 뒤 Cursor를 완전히 종료했다가 재시작하기

"cursor.general.disableHttp2": true

settings.json에 disableHttp2 true 추가하는 화면

여기서 하나 짚고 넘어가야 할 게 있습니다. 이 설정을 켜도 안 통하는 경우가 실제로 보고돼 있습니다. 최근 포럼에는 "always-local-singleton ignores http.proxy and server overrides cursor.general.disableHttp2"라는 제목으로, disableHttp2를 true로 명시해도 서버 쪽 값이 조용히 false로 덮어써서 HTTP/2 연결을 강제하는 버그가 신고돼 있고, 아직 미해결 상태입니다. 설정을 바꿨는데도 증상이 그대로면 이 버그일 가능성을 염두에 두고, 회사 프록시 예외 설정(방화벽 관리자에게 Cursor 트래픽 허용 요청)을 병행하는 게 현실적입니다.

 

체크리스트 ② 로컬 네트워크 문제로 Cursor Internal error가 뜨는 경우

VPN, 와이파이 재접속 직후, 노트북이 절전모드에서 깨어난 직후처럼 네트워크가 순간적으로 끊겼다 붙는 상황에서도 같은 "Internal error"가 뜰 수 있습니다. 7월 12일 포럼 스레드(작성자 cooperx)에서는 스택 트레이스에 "[unknown] Network disconnected"가 찍혔고, 담당자 Colin은 "로컬 연결이나 네트워크 문제로 보인다. 이후에는 정상적으로 요청이 가는 걸 확인했다"고 답했습니다. HTTP/2나 방화벽과는 무관한, 순수하게 개별 네트워크 환경 이슈로 분류된 케이스입니다.

이 경우엔 딱히 설정을 바꿀 필요 없이 다음 정도로 충분합니다.

• 와이파이/유선 연결 상태 확인 후 재연결
• VPN을 쓰고 있다면 잠시 끄고 재시도
• Cursor 앱 재시작

 

체크리스트 ③ 원인 불명 Cursor Internal error, 며칠 지나면 저절로 풀리는 경우

가장 답답한 케이스입니다. 7월 11일 포럼에 올라온 사례가 여기 해당합니다. 사용자 Bittu_Sadhu는 "AI 기능을 쓰려고 할 때마다 Internal error가 뜬다"며 재시작과 재로그인을 시도했지만 소용없었다고 적었습니다. 이 스레드에는 nghttp2나 http2 관련 언급이 전혀 없었고, 담당자 Colin은 이틀 뒤 "토요일 이후로 정상적으로 Cursor를 쓰고 계신 것 같은데, 문제가 자연히 해결됐나요?"라고 물으며 별다른 원인 설명 없이 마무리됐습니다.

이런 유형이면 재시작·재로그인 외에 사용자 쪽에서 딱히 손댈 게 없습니다. 지원팀에 문의 티켓을 남겨두고 시간을 두고 재시도하는 것 말고는 방법이 마땅치 않습니다. 답답하지만, 서버 쪽 일시적 이슈일 가능성이 높다는 뜻이기도 합니다.

 

체크리스트 ④ 그 밖의 서버 측 일시 장애

과거 사례를 보면 Cursor 쪽 인프라가 순간적으로 불안정했다가 스스로 안정화되는 경우도 있었습니다. NGHTTP2_INTERNAL_ERROR 관련 스레드에서 담당자 Condor가 "그 시점에 시스템에 일시적 장애가 있었고 이미 안정화됐다"고 답한 사례가 대표적입니다. 다만 이 스레드는 2025년 8월 사건으로, 2026년 7월 이슈들과는 직접적인 연관이 확인되지 않습니다. NGHTTP2_ENHANCE_YOUR_CALM처럼 서버 측 레이트리밋과 관련된 에러 코드도 있는데, 이런 경우는 사용자가 할 수 있는 게 거의 없고 시간이 지나면 풀리는 편입니다.

Cursor Internal error 원인별 체크 순서 요약 카드

증상이 반복되고 status.cursor.com에도 인시던트가 안 떠 있다면, 억지로 설정을 이것저것 바꾸기보다 잠깐 텀을 두고 재시도하는 쪽이 시간 낭비를 줄입니다.

 

정리 — 순서대로 확인하세요

1. 회사·기관 네트워크를 쓴다 → disableHttp2 설정 + HTTP/1.1 전환부터 시도
2. 방금 와이파이/VPN을 바꿨거나 절전모드에서 깨어났다 → 재연결 후 재시도
3. 특별한 네트워크 변화가 없는데도 갑자기 안 된다 → 몇 시간~하루 정도 텀을 두고 재시도, 지원팀 문의
4. 설정을 다 바꿔도 안 풀린다 → disableHttp2가 서버 측에서 무시되는 버그일 수 있으니 방화벽 관리자에게 Cursor 트래픽 자체를 예외 처리해달라고 요청

이런 프로토콜·네트워크 이슈는 사실 Cursor만의 문제는 아닙니다. Claude Code API 연결 안 될 때 체크리스트에서 다뤘듯이, SSL 인증서나 프록시, QUIC 설정이 AI 코딩 툴의 연결을 끊어먹는 경우는 도구를 가리지 않고 반복됩니다. 프록시 환경에서 일하는 개발자라면 둘 다 체크리스트로 저장해두면 좋습니다.

커서를 팀 단위로 쓰면서 .cursorrules나 프로젝트 규칙까지 손보고 있다면 Cursor Rules vs CLAUDE.md 비교 글도 참고할 만합니다. 그리고 최근 커서 관련 소식이 워낙 빠르게 바뀌고 있어서, 스페이스X의 Cursor 인수 관련 글도 함께 보면 흐름을 잡는 데 도움이 됩니다.

 

FAQ

Q. disableHttp2 설정을 켰는데도 여전히 Internal error가 뜹니다.
서버 측에서 이 설정값을 무시하고 HTTP/2를 강제하는 버그가 포럼에 미해결로 보고돼 있습니다. 설정 변경만으로 안 풀리면 방화벽·프록시 관리자에게 Cursor 도메인 트래픽 예외 처리를 요청하는 게 다음 단계입니다.

Q. Cursor 상태 페이지에는 아무 문제도 없다고 나오는데 왜 저만 안 되나요?
공식 상태 페이지는 회사 차원의 대규모 장애만 표시합니다. 로컬 네트워크, 개인 방화벽 설정, 일시적 서버 이슈처럼 개별적으로 발생하는 문제는 여기에 반영되지 않는 경우가 많습니다.

Q. 얼마나 기다려야 하나요?
원인 불명 케이스는 포럼 사례상 며칠 내에 자연 해결된 경우가 있었습니다. 다만 정해진 시간은 없으니, 하루 이상 지속되면 지원팀에 문의 티켓을 남기는 걸 권합니다.