Windows용 Claude Code Desktop은 SSH로 원격 Mac에 연결할 수 있습니다. Claude Code와 프로젝트 도구는 원격 Mac에서 실행되지만, SSH만으로 Mac 데스크톱이나 Xcode 창이 보이지는 않습니다. 터미널 작업이 과제 요구를 충족하는지 먼저 확인하고, 화면 조작이 필요하면 그래픽 데스크톱 연결을 따로 준비하세요.
Windows에서 Claude Code로 macOS 프로젝트를 다루려는 학생과 초보자에게 맞는 안내입니다.
Swift나 iOS 과제를 시작하기 전에 원격 프로젝트와 명령의 실행 위치를 확인하려는 경우에도 활용할 수 있습니다.
Mac 화면에서 Xcode를 직접 조작해야 한다면 SSH만으로 충분하지 않습니다.
마지막 확인: 2026년 10월 13일. Claude Code Desktop의 원격 SSH 안내와 시스템 요구 사항, Apple의 원격 로그인 문서를 기준으로 확인했습니다. 공식 연결 안내 · Desktop 시스템 요구 사항
[ SECTION_01 ] Claude Code Desktop 원격 Mac 연결의 적합성
먼저 할 일은 원격 Mac에서 필요한 작업이 터미널 중심인지, 화면 조작까지 포함하는지 나누는 것입니다. Claude Code Desktop은 조작 화면으로 사용하고, SSH 세션을 통해 원격 macOS 또는 Linux 호스트에서 Claude Code를 실행하는 흐름을 지원합니다. 최초 연결 시 원격 호스트에 Claude Code를 설치하는 과정이 진행될 수 있습니다. 공식 SSH 세션 안내
| 과제에서 필요한 작업 | SSH 연결 | 그래픽 데스크톱 연결 |
|---|---|---|
| 원격 프로젝트의 파일 읽기와 수정 | 적합합니다 | 가능하지만 필수는 아닙니다 |
| 원격 Mac에서 터미널 명령 실행 | 적합합니다 | 가능하지만 필수는 아닙니다 |
| Xcode 창을 열고 메뉴나 화면 조작 | 화면을 표시하지 않습니다 | 화면 접근 조건을 따로 확인해야 합니다 |
| 시뮬레이터 화면을 직접 확인 | 화면을 표시하지 않습니다 | 그래픽 화면 연결이 필요할 수 있습니다 |
SSH는 멀리 있는 컴퓨터에 명령을 전달하는 통로에 가깝습니다. 원격 데스크톱은 그 컴퓨터의 화면을 보고 마우스와 키보드로 조작하는 방식입니다. 둘을 같은 기능으로 생각하면 연결은 성공해도 과제의 화면 확인 단계에서 막힐 수 있습니다. Apple 화면 공유 안내
[ SECTION_02 ] 연결 전 준비: 호스트, 계정, 과제 폴더
호스트는 접속할 Mac의 주소입니다. 주소를 알고 있어도 누구나 접속할 수 있는 것은 아닙니다. 허가된 SSH 계정과 해당 Mac의 원격 로그인 설정이 필요합니다. Apple은 Mac 설정에서 원격 로그인을 관리하는 방법을 안내합니다. Mac에서 원격 로그인 허용하기
연결 전에 다음 항목을 확인하세요.
- Windows 기기에서 Claude Code Desktop을 사용할 수 있는지 공식 요구 사항을 확인합니다. 기능 이용 가능 여부는 운영체제와 현재 제공 조건에 따라 달라질 수 있습니다.
- 학교나 과제 담당자가 원격 Mac 접속을 허용하는지 확인합니다. 학교 계정이나 네트워크 정책을 우회해서는 안 됩니다.
- 원격 Mac의 주소, SSH 계정 이름, 인증 방법을 접속 관리자에게 확인합니다.
- 과제 파일이 들어 있는 폴더의 경로를 확인합니다. 로컬 Windows 폴더와 원격 Mac의 폴더는 서로 다른 보관함입니다.
- Mac에서 받은 프로젝트라면 현재 과제에 사용할 폴더가 맞는지 확인합니다. 다른 사람이 함께 쓰는 환경이라면 파일을 수정하기 전에 해당 폴더의 사용 권한과 과제 규칙도 확인하세요.
Windows에 SSH 클라이언트가 준비됐는지 확인할 때는 운영체제의 공식 OpenSSH 안내를 참고할 수 있습니다. 학교 기기에서 설치 권한이 없다면 직접 정책을 바꾸지 말고 관리자에게 문의하세요. Windows OpenSSH 첫 설정 안내
[ SECTION_03 ] 첫 연결: Desktop에 SSH 호스트 등록
Claude Code Desktop에서 원격 연결을 추가하고 화면이 요청하는 접속 정보를 입력합니다. 호스트 주소는 목적지, 포트는 접속 통로의 번호, 사용자 이름은 원격 Mac에서 사용할 계정 이름입니다. 개인 키는 문을 여는 열쇠처럼 접속 권한을 증명합니다. 암호와 개인 키는 계정 소유자가 안전하게 보관해야 합니다.
화면의 입력 항목은 앱과 기존 SSH 설정에 따라 다를 수 있습니다. 주소, 포트, 사용자 이름, 인증 파일을 묻는 경우 관리자가 준 정확한 값을 사용하세요. 이미 Windows SSH 설정 파일에 호스트 별칭과 인증 방식이 준비되어 있다면 기존 설정을 사용할 수 있는지 공식 연결 안내를 확인합니다. 특정 입력란이 보이지 않는다고 다른 사람의 설정을 복사하거나 임의로 인증 정보를 바꾸면 안 됩니다. Desktop의 SSH 연결 및 설정 안내
처음 연결할 때 개인 키 파일을 선택하더라도 그 내용을 채팅창에 붙여 넣어서는 안 됩니다. 비밀번호, 개인 키, 접근 토큰도 마찬가지입니다. 접속이 거부되면 비밀 정보를 반복해서 입력하기보다 호스트 주소, 계정 권한, Mac의 원격 로그인 허용 여부를 관리자와 확인하세요.
[ SECTION_04 ] 원격 프로젝트 선택과 실행 위치 확인
연결이 이뤄지면 원격 Mac에 있는 과제 프로젝트 폴더를 선택합니다. Desktop 창이 Windows에 떠 있다고 해서 프로젝트 파일도 Windows에 있거나 명령이 Windows에서 실행되는 것은 아닙니다. 선택한 세션이 연결된 원격 호스트를 가리키는지 확인하는 것이 핵심입니다.
첫 확인은 파일을 바꾸지 않는 작업으로 진행합니다. 터미널에서 현재 폴더 위치를 확인하고, 폴더 안의 파일 목록을 살펴보세요. 화면에 과제 파일과 익숙한 폴더 이름이 보이는지 확인한 다음, Claude Code에 프로젝트 구조를 읽고 설명해 달라고 요청할 수 있습니다. 아직 삭제, 이동, 설치 같은 변경 작업은 시키지 않습니다.
이 절차로도 위치가 불분명하다면 작업을 멈추고 연결 이름과 프로젝트 경로를 확인합니다. 과제 파일이 Windows 쪽 폴더에만 있다면 원격 Mac 세션에서 자동으로 나타날 것이라고 가정하지 마세요. 수업에서 허용한 파일 전송이나 저장소 사용 방법을 확인한 뒤 원격 프로젝트 폴더를 준비해야 합니다.
[ SECTION_05 ] 첫 과제: 차이 확인과 빌드 결과 검토
처음부터 큰 기능을 맡기지 말고 과제의 작은 부분을 대상으로 수정 요청을 합니다. 예를 들어 특정 화면의 안내 문구를 바꾸고 관련 파일만 수정하도록 요청할 수 있습니다. 결과를 받은 뒤에는 수정된 파일과 변경 내용을 직접 살펴봅니다.
Git을 쓰는 프로젝트라면 git diff로 기존 코드와 바뀐 부분을 비교할 수 있습니다. 이 명령의 공식 문서는 차이 확인 방법을 설명합니다. Git 차이 확인 안내 변경 내용이 과제 요구와 맞는지, 불필요한 파일 수정이나 비밀 정보가 포함되지 않았는지 학생이 직접 확인하세요.
과제에서 허용한 빌드 방법으로 결과도 점검합니다. 명령줄 도구로 실행 가능한 확인과 Xcode 창에서 직접 해야 하는 확인은 같지 않습니다. Apple의 Xcode 명령줄 도구 안내는 터미널에서 사용할 수 있는 도구를 설명하지만, SSH가 그래픽 인터페이스를 대신한다고 설명하지는 않습니다. Xcode 명령줄 도구 참고
[ SECTION_06 ] 연결 완료 판단용 체크 목록
아래 항목을 모두 확인하면 SSH 작업을 이어갈지, 그래픽 데스크톱 연결을 추가로 알아볼지 판단할 수 있습니다.
- [ ] 학교나 과제 담당자에게 원격 접속과 사용 계정의 허가를 확인했습니다.
- [ ] Claude Code Desktop에서 연결한 호스트가 과제에 사용할 원격 Mac인지 확인했습니다.
- [ ] 원격 세션에서 과제 프로젝트 폴더와 예상 파일을 확인했습니다.
- [ ] 파일을 바꾸지 않는 점검으로 원격 프로젝트와 실행 위치를 확인했습니다.
- [ ] 작은 변경 사항을 검토하고 과제 요구에 맞는지 직접 확인했습니다.
- [ ] 과제가 Xcode 창이나 시뮬레이터 화면을 요구하는지 확인했습니다.
코드 수정과 터미널 실행만 필요하고 위 항목을 통과했다면 SSH 작업을 계속할 수 있습니다. 과제가 Xcode 인터페이스 조작이나 시뮬레이터 화면 제출을 요구한다면 그래픽 데스크톱 연결 조건을 따로 확인하세요.
[ SECTION_07 ] 자주 묻는 질문
Windows용 Claude Code Desktop에서 원격 Mac에 연결할 수 있나요?
가능합니다. 다만 앱 화면만 설치한다고 연결되는 것은 아닙니다. 접속할 Mac에서 SSH 연결이 허용되어야 하고, 사용할 계정과 호스트 정보도 준비되어야 합니다. 학교 네트워크나 관리 기기에서 원격 접속이 제한될 수 있으므로 먼저 담당자에게 허용 여부를 확인하세요. SSH 연결은 터미널 작업과 원격 프로젝트 접근을 위한 것이며 Mac 화면을 보여주는 기능은 아닙니다.
Claude Code Desktop에 SSH 원격 호스트를 어떻게 추가하나요?
Desktop의 원격 연결 흐름에서 호스트 주소와 접속 계정을 입력하고, 화면에 표시되는 인증 설정을 완료합니다. 포트나 개인 키 파일을 지정하는 입력란은 사용하는 설정에 따라 달라질 수 있습니다. 이미 Windows의 SSH 설정 파일에 접속 별칭과 인증 정보가 있다면 그 설정을 활용할 수 있는지 공식 안내를 확인하세요. 개인 키는 다른 사람에게 보내거나 Claude Code 프롬프트에 붙여 넣지 마세요.
원격 Mac에 연결하면 코드와 명령은 어디에서 실행되나요?
Desktop은 Windows에서 조작하는 화면 역할을 하고, 원격 세션에서 선택한 프로젝트와 실행 명령은 연결된 Mac 쪽에서 처리됩니다. 따라서 파일을 확인할 때는 원격 프로젝트 폴더를 선택했는지 먼저 살펴야 합니다. 터미널에서 현재 위치를 확인하고, 읽기 전용으로 파일 목록을 확인하면 작업이 어느 컴퓨터에서 이뤄지는지 점검하는 데 도움이 됩니다.
SSH로 연결한 상태에서 Xcode 화면이나 시뮬레이터를 조작할 수 있나요?
SSH는 명령줄과 파일을 다루는 연결이므로 그 자체로 Xcode 창이나 시뮬레이터 화면을 보여주지 않습니다. 터미널에서 가능한 빌드 작업과 앱 화면을 열어 직접 확인하는 일은 서로 다른 작업입니다. 과제에서 Xcode 인터페이스 조작이나 시뮬레이터 화면 제출을 요구한다면, 원격 Mac의 그래픽 데스크톱에 접속할 수 있는지 별도로 확인하고 학교의 접속 정책도 따르세요.
현재 Windows 환경만으로 과제를 진행하면 macOS에서만 쓸 수 있는 도구를 직접 실행하기 어렵고, 학교 기기에서는 설치 권한이나 접속 정책에 막힐 수 있습니다. 반대로 원격 Mac을 SSH로 쓰면 터미널 기반 작업은 이어갈 수 있지만, Xcode 화면 검수가 필요한 과제에는 그래픽 연결이 추가로 필요합니다. 이미 쓸 수 있는 Mac이 있다면 먼저 그 환경을 활용하세요. 없다면 원격 Mac 이용 안내와 Mac mini 대여 방식 및 요금 안내를 살펴보고 과제 요건에 맞는지 확인할 수 있습니다. NOVAKVM은 실제 Mac에 원격으로 접속하는 이용 방식을 제공하므로, 단기간 과제 환경이 필요한 학생은 필요한 연결 방식과 학교의 허용 여부를 확인한 뒤 선택하면 됩니다.