클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Windows 원격 데스크톱 연결 진단 의사

macOS의 Windows App(원격 데스크톱/AVD/W365/직접 PC) 연결 지연·멈춤 문제를 전송 프로토콜과 로그 증거로 진단해 고칩니다.

유틸리티중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

macOS에서 Windows App(구 Microsoft Remote Desktop)으로 Azure Virtual Desktop, Windows 365, 또는 집/사무실 PC에 직접 접속할 때 발생하는 느림·끊김·멈춤 문제를 단계별로 진단합니다.

  • 전송 프로토콜 판별: UDP Shortpath가 잡혔는지, WebSocket/TCP로 폴백했는지 확인
  • 네트워크 증거 수집: ifconfig, netstat, scutil --proxy, lsof로 VPN/프록시 TUN(utun, 198.18.0.x) 간섭 탐지
  • Windows App 로그 분석: ~/Library/Containers/com.microsoft.rdc.macos/.../Logs의 세션 GUID별 이벤트를 묶어 FetchClientOptions timeout, 인증서 검증 실패, OneAuthError_InteractionRequired 같은 결정적 패턴 추출
  • 원인 분류 A~F: VPN/프록시 간섭, ISP의 UDP 차단, 클라이언트 헬스체크 실패, 서버측 Shortpath 미설정, 만료된 MS 회사/학교 계정으로 인한 인증 오염, Windows 업데이트 재부팅
  • 동봉된 scripts/probe_rdp_server.py로 자격증명 없이 RDP+TLS 서버 생존 여부를 독립 검증

이런 분께 추천

  • 회사 VDI(AVD/W365)를 Mac으로 쓰는데 유독 반응이 느린 개발자·디자이너
  • 재택근무 중 집 PC에 RDP로 붙는데 "원격 PC 구성 중..."에서 멈추는 분
  • Clash/ShadowRocket/Tailscale 같은 프록시·VPN을 상시 켜두고 일하는 분
  • 사용자 티켓의 원인을 로그로 증명해야 하는 IT 헬프데스크·인프라 담당자

활용 예시

  1. "AVD 연결 정보에 Transport Protocol이 WebSocket이고 RTT가 165ms인데 왜 UDP가 안 잡히나?" → 스킬이 utun 라우팅과 STUN/TURN 로그를 확인해 프록시에 DOMAIN-SUFFIX,wvd.microsoft.com,DIRECT 예외를 넣도록 안내.
  2. "집 PC 접속이 '원격 PC 구성 중...'에서 5분째 멈춰 있어요" → probe 스크립트로 3389 포트가 정상임을 증명한 뒤, 로그의 UserCancelled(8)/토큰 없음 신호로 만료된 회사 계정 제거 → 앱 완전 종료 후 재실행을 처방.
  3. "어제까지 잘 됐는데 갑자기 끊기고 재접속이 안 돼요" → CMSTATE_DROPPED 시점과 Windows의 LastBootUpTime·이벤트 ID 1074를 비교해 Windows Update 자동 재부팅을 원인으로 특정하고 활성 시간 설정을 제안.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 windows-remote-desktop-connection-doctor 폴더를 내 ~/.claude/skills/windows-remote-desktop-connection-doctor/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/windows-remote-desktop-connection-doctor ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다(스포트라이트에서 "터미널" 검색).
  2. 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 이 스킬만 복사합니다: cp -r claude-code-skills/windows-remote-desktop-connection-doctor ~/.claude/skills/
  5. 복사 확인: ls ~/.claude/skills/windows-remote-desktop-connection-doctor → SKILL.md, scripts, references가 보이면 성공입니다.
  6. Claude Code를 다시 시작하고 "Windows App으로 RDP 접속이 느린데 진단해줘"처럼 요청하면 스킬이 자동 호출됩니다.
  7. 진단 중 python3 scripts/probe_rdp_server.py <호스트> 3389 실행을 요청받을 수 있으니 macOS 기본 python3(또는 Xcode 커맨드라인 도구)이 설치돼 있는지 확인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT