VS Code 원격 Mac 연결 계속 비밀번호? 2026 초보자 해결

VS Code의 Remote - SSH는 먼저 SSH 인증을 시도한 뒤 원격 Mac에 VS Code Server를 설치하거나 실행합니다. 따라서 비밀번호 창이 나타난 위치가 중요합니다. Visual Studio Code 공식 문서도 인증, 로그, 서버 설치를 별도 문제로 다룹니다. Remote - SSH의 인증과 연결 절차를 먼저 확인해도 좋습니다.

• 연결 시작 직후 비밀번호 요청: 사용자 이름, 주소, 포트, 비밀번호를 확인합니다.
• 키 암호 요청: 개인 키는 찾았지만 키 자체에 설정된 암호를 요구하는 상황일 수 있습니다.
• 인증 뒤 설치 반복: 비밀번호보다 VS Code Server 다운로드, 실행 권한, 원격 네트워크를 확인합니다.
• 호스트 지문 경고: 접속 대상이 바뀌었는지 제공자에게 확인합니다. 검사를 끄고 진행하지 않습니다.

Remote - SSH는 입력한 비밀번호나 다른 인증 토큰을 저장하지 않습니다. 새 세션에서 다시 물을 수 있으므로, 반복 입력 자체만으로 계정 오류라고 판단하면 안 됩니다. 이 동작은 공식 Remote - SSH 안내에 명시되어 있습니다.

주의: 호스트 지문 확인을 끄거나, 원격 포트를 공개하거나, 여러 학생이 하나의 계정을 공유하는 방식은 인증 문제를 해결하지 못합니다. 오히려 접속 대상을 잘못 선택하거나 계정 기록을 잃게 만들 수 있습니다.

VS Code를 수정하기 전에 윈도우 터미널에서 같은 접속 정보를 사용합니다. VS Code가 다른 설정을 읽고 있는지 분리하는 단계입니다.

1. 윈도우 터미널을 엽니다.
2. VS Code에 입력한 사용자 이름, 원격 Mac 주소, 포트를 기록합니다.
3. 같은 정보로 일반 SSH 접속을 시도합니다.
4. 비밀번호 또는 키 암호를 입력합니다.
5. 원격 Mac의 셸이 열리는지 확인합니다.
6. exit로 나간 뒤 다시 접속해 결과가 같은지 봅니다.

성공하면 원격 셸 명령을 입력할 수 있습니다. 이 결과는 네트워크와 기본 인증이 적어도 동작한다는 뜻입니다. 그다음 VS Code의 출력 패널로 이동합니다.

실패 현상별 확인 순서는 다음과 같습니다.

• 사용자를 찾을 수 없음: 원격 Mac에서 허용된 계정 이름을 다시 확인합니다.
• 접속 거부: macOS의 원격 로그인이 켜져 있고 해당 계정이 허용됐는지 확인합니다. Apple은 시스템 설정의 공유 항목에서 원격 로그인 접근을 관리하도록 안내합니다. Apple의 macOS 원격 로그인 안내를 기준으로 확인합니다.
• 시간 초과: 주소, 포트, 학교 네트워크 제한을 확인합니다. 여러 번 비밀번호를 바꾸는 단계가 아닙니다.
• 호스트 키 변경 경고: 원격 Mac을 관리하는 제공자에게 대상 변경 여부를 묻습니다. 직접 지문 검사를 삭제하지 않습니다.

일반 SSH도 실패하면 VS Code 설정을 먼저 고칠 이유가 없습니다. 계정 권한, 원격 로그인, 주소 또는 네트워크를 제공자와 해결한 뒤 다음 단계로 넘어갑니다.

비밀번호 방식은 시작하기 쉽습니다. 다만 새 연결마다 입력할 수 있고, 학교 컴퓨터에서는 비밀번호 자동 저장이 제한될 수 있습니다. 키 방식은 개인 키와 원격 Mac에 등록된 공개 키가 한 쌍으로 맞아야 합니다.

초보자에게는 다음 비유가 도움이 됩니다. 공개 키는 교실 출입 명부에 등록된 이름입니다. 개인 키는 실제 열쇠입니다. 키 암호는 열쇠 보관함을 여는 추가 잠금입니다. 세 가지 중 하나라도 맞지 않으면 자동 로그인이 되지 않습니다.

윈도우에서 확인할 순서

1. 개인 키 파일이 현재 윈도우 사용자 폴더에 있는지 확인합니다.
2. SSH 설정 파일이 다른 파일을 가리키지 않는지 확인합니다.
3. 사용자 이름과 주소가 키를 등록한 원격 계정과 같은지 비교합니다.
4. ssh-agent가 실행되고 키를 읽었는지 확인합니다.
5. VS Code가 아니라 일반 SSH로 키 인증을 시험합니다.
6. 성공한 뒤 VS Code를 완전히 닫고 다시 연결합니다.

윈도우 OpenSSH의 키 관리와 ssh-agent 사용 방법은 Microsoft의 공식 키 관리 문서에서 확인할 수 있습니다. 학교 컴퓨터의 정책 때문에 에이전트를 실행할 수 없다면 정책을 우회하지 말고, 허용된 비밀번호 방식이나 담당자에게 승인받은 키 방식을 선택합니다.

개인 키를 코드 저장소, 채팅 창, 과제 제출 폴더에 복사하면 안 됩니다. 키가 노출됐다면 파일을 지우는 것만으로 충분하지 않을 수 있습니다. 원격 Mac에 등록된 공개 키를 폐기하거나 새 키를 발급해야 합니다.

일반 SSH가 성공한 뒤에도 VS Code가 연결되지 않는다면 인증과 서버 설치를 분리합니다. VS Code에서 Remote - SSH 출력 패널을 열고 다음 단어가 어느 단계에서 나타나는지 봅니다.

• 인증 요청 전후의 사용자 이름과 주소
• 키 파일을 찾았는지 여부
• 원격 서버 설치 시작 여부
• 다운로드 실패 또는 실행 권한 오류
• 연결 종료와 재시도 메시지

인증 성공 뒤 VS Code Server 설치가 계속 반복된다면 비밀번호를 다시 입력해도 해결되지 않을 가능성이 큽니다. 원격 Mac이 필요한 파일을 내려받을 수 있는지, 원격 디렉터리에 쓸 수 있는지, 연결이 중간에 끊기는지를 확인합니다. 공식 문제 해결 문서는 로그 확인과 서버 설치 문제를 따로 안내합니다. Remote - SSH 공식 문제 해결 문서를 기준으로 진행합니다.

VS Code Server 설치 파일은 공식 확장 흐름이 관리하도록 두는 편이 안전합니다. 검색 결과의 임의 스크립트나 출처가 불명확한 압축 파일을 받아 실행하지 않습니다. 학교 계정에 관리자 권한이 없다는 이유로 보안 설정을 우회해서도 안 됩니다.

이 표의 핵심은 “비밀번호가 보인다”가 아니라 “어느 단계에서 보이는가”입니다.

수정이 끝났다고 바로 과제 파일을 열지 않습니다. 다음 순서로 한 번의 검증을 진행합니다.

• VS Code를 완전히 종료합니다.
• 다시 실행하고 동일한 원격 Mac 항목을 선택합니다.
• 비밀번호 또는 키 암호 요청이 어느 시점에 나오는지 기록합니다.
• 원격 탐색기에서 학습용 디렉터리를 엽니다.
• VS Code 터미널에서 현재 위치를 확인합니다.
• 새 테스트 파일을 만들고 한 줄을 저장합니다.
• 파일을 닫았다가 다시 열어 저장 결과를 확인합니다.
• 터미널에서 간단한 Python 또는 프런트엔드 명령을 실행합니다.
• 연결을 끊고 같은 프로젝트를 다시 엽니다.

인증이 끝났고 원격 디렉터리, 터미널, 저장이 모두 정상이라면 비밀번호를 한 번 더 묻는지보다 학습 작업이 이어지는지를 기준으로 판단합니다. 반대로 매번 서버 설치부터 다시 시작되면 계정 설정을 더 만지기보다 로그를 보관해 환경 제공자에게 전달합니다.

Windows에서 처음 원격 Mac을 설정하는 과정이 필요하다면 윈도우 원격 Mac 연결 안내에서 제공 방식과 접속 조건을 먼저 확인하는 편이 좋습니다. 비용과 이용 기간을 비교할 때는 Mac 미니 대여 가격 안내도 함께 살펴보되, 수업에 필요한 SSH 권한과 독립 계정이 실제로 제공되는지 우선 확인해야 합니다.

현재 사용하는 컴퓨터가 학교 정책으로 SSH 키나 에이전트를 실행할 수 없고, 원격 Mac도 독립 계정과 안정적인 학습 디렉터리를 제공하지 않는다면 같은 오류를 반복해서 고치기 어렵습니다. 공유 계정은 키 관리가 불분명하고, 임의의 가상 Mac 환경은 macOS 전용 도구나 원격 로그인 조건이 맞지 않을 수 있습니다.

이 경우에는 필요한 기간만 MESHLAUNCH의 원격 Mac 환경을 검토할 수 있습니다. 실제 선택 전에는 계정 인증 방식, SSH 사용 가능 여부, 프로젝트 저장 위치, 재연결 방법을 확인해야 합니다. 장기간 매일 무거운 작업을 하거나 물리 장치가 필요한 경우에는 직접 Mac을 마련하는 편이 더 적합할 수 있습니다. 반대로 학기 중 과제, Xcode 확인, Python 또는 프런트엔드 실습처럼 임시 개발 환경이 필요한 경우에는 대여 방식이 구매보다 부담이 작을 수 있습니다.

마지막으로 수업에 사용할 연결 방식과 계정 권한을 목록으로 남겨 두십시오. 일반 SSH가 성공하는지 먼저 확인하고, 인증 성공 뒤 서버 설치가 반복되는지 분리하면 비밀번호 창만 보고 계정을 계속 바꾸는 실수를 피할 수 있습니다.