Common Issues

Solutions for common problems and FAQs

아래는 흔히 겪는 이슈와 해결 방법이야.

네트워킹 이슈

먼저 네트워크 연결을 확인해. Cursor Settings > Network로 가서 Run Diagnostics를 클릭해. 그러면 Cursor 서버와의 연결을 테스트하고, AI 기능, 업데이트, 기타 온라인 기능에 영향을 줄 수 있는 네트워크 문제를 확인할 수 있어.

Cursor는 스트리밍 응답을 효율적으로 처리하기 위해 AI 기능에 HTTP/2를 사용해. 네트워크가 HTTP/2를 지원하지 않으면 인덱싱 실패나 AI 기능 문제가 생길 수 있어.

이건 기업 네트워크, VPN, 또는 Zscaler 같은 프록시를 사용할 때 자주 발생해.

이걸 해결하려면 앱 설정(커서 설정 아님)에서 HTTP/1.1 폴백을 켜줘: CMD/CTRL + ,를 누르고 HTTP/2를 검색한 다음 Disable HTTP/2를 활성화해. 그러면 HTTP/1.1을 강제로 사용하게 되어 문제가 해결돼.

자동 감지와 폴백은 곧 추가할 예정이야.

리소스 이슈(CPU, RAM 등)

CPU나 RAM 사용량이 높으면 기기가 느려지거나 리소스 경고가 뜰 수 있어.

큰 코드베이스일수록 리소스를 더 많이 쓰지만, 높은 사용량은 보통 확장 프로그램이나 설정 문제에서 비롯돼.

MacOS에서 낮은 RAM 경고가 보인다면, 일부 사용자에게 값이 크게 잘못 표시되는 버그가 있어. 이런 경우라면 Activity Monitor를 열고 “Memory” 탭에서 정확한 메모리 사용량을 확인해줘.

CPU나 RAM 사용량이 높다면 아래 단계를 시도해봐:

확장 프로그램 확인

확장 프로그램은 성능에 영향을 줄 수 있어.

Extension Monitor는 설치한 확장 프로그램과 기본 제공 확장 프로그램의 리소스 사용량을 보여줘.

Settings > Application > Experimental에서 Extension Monitor: Enabled를 토글해 확장 모니터를 켜줘. 그러면 Cursor를 재시작하라는 프롬프트가 뜰 거야.

여는 법: Cmd/Ctrl + Shift + P → Developer: Open Extension Monitor.

Cursor는 하나 이상의 extension host에서 확장 프로그램을 실행해. 보통 대부분의 확장 프로그램이 같은 extension host에서 실행돼서, 특정 확장 프로그램이 CPU 시간을 과도하게 쓰면 이웃한 확장 프로그램들이 영향을 받을 수 있어!

Extension Monitor에서는 다음을 볼 수 있어:

• 확장 프로그램이 실행한 모든 장기 실행 프로세스(MacOS, Linux만).
• % Ext Host: 이 확장 프로그램이 사용한 전체 extension host 시간의 비율. 다른 확장 프로그램 대비 누가 가장 시간을 쓰는지 파악하는 데 도움 돼.
• Max Blocking: 모니터링 간격당 이 확장 프로그램의 최장 연속 실행 차단 시간.
• % CPU:
  • 확장 프로그램: 해당 확장 프로그램 코드에 귀속되는 전체 CPU 사용량의 비율.
  • 프로세스: 실행된 프로세스에 귀속되는 전체 CPU 사용량의 비율(MacOS, Linux만).
• Memory:
  • 확장 프로그램: 확장 프로그램 코드가 사용하는 JS 힙 메모리 양(외부 할당 제외).
  • 프로세스: 실행된 프로세스가 사용하는 시스템 메모리 양(MacOS, Linux만).

커맨드라인에서 cursor --disable-extensions를 실행해 테스트할 수도 있어. 성능이 좋아지면 문제 있는 확장 프로그램을 찾을 때까지 하나씩 다시 활성화해봐.

Extension Bisect로 문제 확장 프로그램을 찾아봐. 자세한 내용은 여기를 참고해줘. 참고: 이 방법은 점진적 성능 저하보다는 즉각적으로 발생하는 이슈에 더 효과적이야.

Process Explorer 사용

Process Explorer는 어떤 프로세스가 리소스를 쓰는지 보여줘.

여는 법: Command Palette(Cmd/Ctrl + Shift + P) → Developer: Open Process Explorer.

아래 항목의 프로세스를 확인해:

• extensionHost: 확장 프로그램 관련 이슈
• ptyHost: 터미널 리소스 사용

Process Explorer는 각 터미널과 진단을 위한 실행 중인 명령을 표시해.

다른 고사용량 프로세스는 forum에 보고해줘.

시스템 리소스 모니터링

운영체제의 모니터링 도구를 사용해 문제가 Cursor에 국한된 건지, 시스템 전반의 문제인지 판단해줘.

최소 구성 설치로 테스트

문제가 계속되면 최소 구성으로 Cursor를 설치해 테스트해봐.

일반 FAQ

변경 로그에 업데이트가 보이는데 Cursor가 업데이트되지 않아

새 업데이트는 단계적 롤아웃으로 배포돼. 무작위로 선택된 사용자에게 먼저 업데이트가 가고, 며칠 내로 업데이트될 거야.

Cursor에서 GitHub 로그인이 문제야 / Cursor에서 GitHub에서 어떻게 로그아웃해?

커맨드 팔레트 Ctrl/⌘ + Shift + P에서 Sign Out of GitHub를 실행해.

GitHub Codespaces를 사용할 수 없어

GitHub Codespaces는 아직 지원하지 않아.

Remote SSH 연결에 오류가 있어

Mac이나 Windows 머신으로의 SSH는 지원하지 않아. 다른 이슈는 로그와 함께 forum에 보고해줘.

Windows에서 SSH 연결 문제

“SSH is only supported in Microsoft versions of VS Code”가 보이면:

1. Remote-SSH 제거:

   • 확장(Extensions) 보기 열기 (Ctrl + Shift + X)
   • “Remote-SSH” 검색
   • 톱니바퀴 아이콘 클릭 → “Uninstall”

2. Anysphere Remote SSH 설치:

• Cursor 마켓플레이스 열기
• “SSH” 검색
• Anysphere Remote SSH 확장 설치

3. 설치 후:

• SSH 연결이 활성화된 모든 VS Code 인스턴스 종료
• Cursor 재시작
• SSH로 다시 연결

SSH 설정과 키가 제대로 구성돼 있는지 확인해줘.

회사 프록시 뒤에서 Cursor Tab과 Inline Edit가 작동하지 않아

Cursor Tab과 Inline Edit는 지연 시간과 리소스 사용을 줄이기 위해 HTTP/2를 사용해. 일부 기업 프록시(예: Zscaler)는 HTTP/2를 차단해. 설정에서 "cursor.general.disableHttp2": true로 바꿔서 해결해 (Cmd/Ctrl + , 후 http2 검색).

방금 Pro를 구독했는데도 앱에서 아직 무료 플랜이야

Cursor Settings에서 로그아웃했다가 다시 로그인해.

사용량은 언제 다시 초기화돼?

Pro 구독자: 갱신일을 보려면 Dashboard에서 Manage Subscription을 클릭해.

무료 사용자: 첫 번째 Cursor 이메일 날짜를 확인해. 그 날짜를 기준으로 매달 사용량이 초기화돼.

업데이트 후 Chat/Composer 기록이 사라졌어

디스크 여유 공간이 부족하면 업데이트 중에 Cursor가 이전 데이터를 지울 수 있어. 방지하려면:

1. 업데이트 전에 충분한 여유 디스크 공간 유지
2. 불필요한 시스템 파일 정기적으로 정리
3. 업데이트 전에 중요한 대화 백업

Cursor는 어떻게 제거해?

이 가이드를 따라줘. “VS Code” 또는 “Code”를 “Cursor”로, “.vscode”를 “.cursor”로 바꿔.

계정은 어떻게 삭제해?

Dashboard에서 Delete Account를 클릭해. 이 작업은 계정과 모든 관련 데이터를 영구적으로 삭제해.

커맨드 라인에서 Cursor를 어떻게 열어?

터미널에서 cursor를 실행해. 명령이 없으면:

1. 커맨드 팔레트 열기 ⌘⇧P
2. install command 입력
3. Install 'cursor' command 선택 (원하면 VS Code를 덮어쓰도록 code 명령도 설치)

Cursor에 로그인할 수 없어

Sign In을 클릭하면 cursor.com으로 이동하지만 로그인되지 않으면, 방화벽이나 백신 소프트웨어를 잠시 꺼줘. 로그인 과정을 차단할 수 있어.

의심스러운 활동 메시지

최근 시스템 오남용 증가로 인해 보안상 요청이 차단됐을 수 있어. 이렇게 해결해봐:

먼저 VPN을 확인해. 사용 중이면 꺼봐. VPN이 보안 시스템을 트리거할 때가 있어.

그래도 해결되지 않으면 다음을 시도해봐:

• 새 채팅 만들기
• 잠시 기다렸다가 나중에 다시 시도
• Google 또는 GitHub 인증으로 새 계정 만들기
• Cursor Pro로 업그레이드