VS Code/Cursor SSH 운영체제 변경

VS Code/Cursor SSH 운영체제 변경

Windows 원격 서버에 SSH로 접속하려는데, 터미널이 PowerShell이 아닌 WSL(Bash)로 열리거나 아예 접속이 안 되는 문제가 발생할 때가 있다.

이는 VS Code나 Cursor가 해당 호스트의 운영체제를 Linux로 잘못 인식(캐싱)하고 있기 때문이다. 이를 Windows로 강제 지정하여 해결하는 방법을 정리한다.

1. 문제 현상

• 목표: Windows 원격 PC에 SSH 접속 (PowerShell 환경 사용)
• 증상:
  1. 접속 시 무한 로딩이 걸리거나 실패한다.
  2. 접속은 되나 터미널이 dev@hostname 같은 리눅스(WSL) 환경으로 열린다.
  3. 파일 탐색 경로가 C:\가 아닌 리눅스 홈 디렉터리로 보인다.
• 원인: 최초 접속 시 플랫폼을 'Linux'로 잘못 선택했거나, 에디터가 OS를 자동으로 잘못 감지했다.

---

2. 해결 방법: Platform 설정 강제 지정 (핵심)

가장 확실한 해결 방법은 에디터 설정에서 "이 호스트는 Windows다"라고 명시하는 것이다.

1. 설정 메뉴 진입

   • VS Code / Cursor에서 F1 (또는 Ctrl + Shift + P)을 입력한다.
   • Remote-SSH: Settings를 검색하여 선택한다.

2. Remote Platform 항목 추가

   • 설정 화면에서 platform을 검색하거나 Remote.SSH: Remote Platform 항목을 찾는다.
   • [Add Item] 버튼을 클릭한다.
   • Item (Key): config 파일에 적은 Host 이름 (예: Junyong, Lab03)
   • Value: windows 선택

참고: 이렇게 설정하면 에디터가 더 이상 OS를 묻거나 추측하지 않고, 무조건 Windows용 서버 파일을 다운로드하여 실행한다.

---

3. (선택) 꼬인 서버 파일 초기화

설정을 변경했는데도 접속이 불안정하다면, 기존에 잘못 설치된 리눅스용 서버 파일이 남아있기 때문이다. 이를 삭제하여 초기화한다.

터미널에서 아래 명령어로 서버 폴더 삭제:

# VS Code의 경우
rm -rf .vscode-server

# Cursor의 경우
rm -rf .cursor-server


서버에 직접 접근이 어렵다면, 접속된 에디터의 터미널이나 rm -rf /mnt/c/Users/사용자명/.cursor-server 명령어를 활용하여 삭제한다.

이 폴더들은 재접속 시 올바른 OS 버전으로 자동 생성되므로 삭제해도 무방하다.