VS Code 제한 모드 해제·폴더 신뢰 관리: Workspace Trust를 안전하게 설정하는 방법

VS Code에서 폴더를 열었는데 ‘Restricted Mode’가 보이고 터미널이나 디버깅이 동작하지 않나요? 이는 파일이 고장 났다는 뜻이 아니라 프로젝트 코드의 자동 실행을 제한하는 Workspace Trust 기능일 수 있습니다. 모르는 저장소를 내려받았다면 무조건 해제하기보다 출처와 실행 설정부터 살펴보세요.

빠른 결론

내용 확인만 할 때는 제한 모드를 유지해도 됩니다.
출처를 확인한 폴더만 Manage Workspace Trust에서 Trust로 전환하세요.
상위 폴더를 신뢰하면 그 아래 모든 하위 폴더에도 적용됩니다.

기준: 2026년 10월 16일 KST, VS Code 데스크톱 공식 Workspace Trust 문서. 버전·언어팩에 따라 표시가 달라질 수 있어 아래 명령과 버튼은 공식 영문 이름을 함께 적었습니다. 실제 PC에서 모든 확장을 시험한 사용 후기는 아닙니다.

제한 모드에서 무엇이 달라지나요?

기능	공식 안내와 점검 포인트
코드 읽기·수정	가능합니다. 다만 일부 언어 지원 기능은 제한될 수 있습니다.
터미널·작업·디버깅	기본적으로 차단되거나 신뢰 확인을 요구합니다. 프로젝트가 실행할 명령부터 확인합니다.
확장 프로그램	제한 모드를 지원하지 않으면 비활성화 또는 일부 기능 제한 상태가 됩니다.
워크스페이스 설정	실행 파일 경로처럼 위험을 만들 수 있는 일부 설정이 적용되지 않습니다.
AI 에이전트	신뢰하지 않은 작업 공간에서는 실행되지 않는다고 현재 공식 문서가 안내합니다.

1. 지금 열린 폴더의 신뢰 상태 확인

1. VS Code 위쪽 Restricted Mode 배너의 Manage를 누르거나 아래 상태 표시줄의 Restricted Mode를 선택합니다.
2. 배너가 없다면 Windows·Linux는 Ctrl+Shift+P, macOS는 Shift+Command+P로 Command Palette를 엽니다.
3. Workspaces: Manage Workspace Trust를 검색해 실행합니다. 열린 Workspace Trust 화면에서 현재 상태와 제한된 기능을 확인합니다.

단축키를 재지정했다면 명령 팔레트의 단축키가 다를 수 있습니다. 제한 모드는 프로젝트 폴더 단위의 판단이며 VS Code 로그인이나 설정 동기화 여부와는 별개입니다.

2. 출처를 확인한 폴더만 신뢰하기

1. 저장소 주소·작성자·배포 경로를 확인하고, 낯선 프로젝트라면 소스를 먼저 읽습니다. 특히 .vscode 아래 작업·디버그·설정 파일과 실행 스크립트를 살펴봅니다.
2. 확인 전에는 모드를 유지합니다. 공식 문서상 텍스트 편집은 가능하므로 ‘읽으려면 먼저 신뢰해야 한다’고 생각할 필요가 없습니다.
3. 안전성을 판단한 뒤 Workspace Trust 화면의 Trust를 누릅니다. Trusted Folders & Workspaces 목록에 추가되는 경로가 의도한 폴더인지 확인합니다.
4. 필요했던 터미널·작업·디버깅 기능을 다시 확인합니다. 신뢰는 실행을 허용하는 결정이지 프로젝트가 안전하다는 검사 합격증이 아닙니다.

3. 신뢰 취소와 상위 폴더 범위 정리

1. 같은 Workspaces: Manage Workspace Trust 명령을 실행합니다.
2. 현재 폴더의 Don't Trust를 선택하거나 Trusted Folders & Workspaces 목록에서 해당 경로를 제거합니다.
3. Don't Trust가 없다면 상위 폴더에서 신뢰가 상속되는지 목록을 확인합니다. 예를 들어 개발 폴더 전체를 신뢰하면 새로 받은 하위 저장소도 신뢰 대상이 됩니다.
4. 범위가 너무 넓다면 상위 경로를 제거하고 검증한 개별 프로젝트만 다시 추가합니다. 다른 프로젝트도 영향을 받으므로 경로를 읽고 판단하세요.

주의사항과 해결되지 않을 때 추가 점검

• 제한 모드는 악성 확장이 이를 무시하고 코드를 실행하는 것까지 막지 못합니다. 신뢰할 수 있는 게시자의 확장만 설치하세요.
• 기능이 안 된다는 이유로 Workspace Trust 전체를 끄거나 확장 지원 상태를 강제로 덮어쓰는 방법을 첫 해결책으로 삼지 마세요.
• 확장 문제는 Workspace Trust 화면의 extensions are disabled or have limited functionality 링크로 확인합니다. 공식 안내의 필터는 @workspaceUnsupported입니다.
• 신뢰 후에도 실행이 안 되면 확장의 별도 오류, 런타임 설치, 작업 경로 등을 확인합니다. 모든 실행 실패가 제한 모드 때문은 아닙니다.
• 이미 실행된 코드의 변경을 신뢰 취소가 되돌리지는 않습니다. 의심스러운 명령을 실행했다면 자격 증명 노출 여부 등 별도 보안 점검이 필요합니다.

FAQ

Q1. 제한 모드를 유지하면 파일을 저장할 수 없나요?

아닙니다. 공식 문서는 소스 탐색과 텍스트 편집을 지원한다고 안내합니다. 일부 언어·확장 기능 제한과 파일 수정 불가를 구분하세요.

Q2. Don't Trust 버튼이 왜 안 보이나요?

상위 경로에서 신뢰를 상속받을 수 있습니다. Trusted Folders & Workspaces 목록을 먼저 확인하세요. 일부 관리형 원격 환경은 자동 신뢰되는 경우도 있습니다.

Q3. GitHub에 공개된 코드라면 바로 Trust를 눌러도 되나요?

공개 여부만으로 안전을 보장하지 않습니다. 작성자와 저장소 출처, 실행 설정을 검토하고 확신이 없으면 제한 모드에서 읽는 편이 낫습니다.

함께 읽기

• VS Code 설정 동기화 켜기·끄기: 신뢰 설정과 계정 동기화 구분
• VS Code 자바 개발 환경: JDK·확장 설치와 실행 순서

공식 출처

Visual Studio Code: Workspace Trust의 Restricted Mode, Trusting a workspace, Selecting folders, Common questions를 2026년 10월 16일 KST에 확인했습니다. 설치된 버전의 화면이 다르면 공식 문서와 실제 경로를 대조하세요.