VS Code 제한 모드는 새로 연 폴더의 코드를 검토하는 동안 자동 실행을 제한하는 보호 기능이다. 외부 저장소를 내려받은 뒤 실행이나 확장 기능이 막혔다면, 먼저 작업 영역 신뢰 상태를 확인하면 된다. 파일을 읽고 수정하는 일은 계속할 수 있으며, 실행에 필요한 설정을 살펴본 뒤 해당 폴더의 신뢰 여부를 결정하면 된다.
VS Code 제한 모드가 뜨는 이유와 현재 기본 설정
작업 영역 신뢰는 VS Code와 확장이 프로젝트의 코드를 실행하도록 허용할지 판단하는 설정이다. 처음 접하는 폴더를 열거나 작성자를 신뢰하지 않는다고 선택하면 제한 모드가 적용될 수 있다. 화면 위쪽 배너나 아래쪽 상태 표시줄의 Restricted Mode 표시로 현재 상태를 확인할 수 있다.
2026년 10월 확인한 Microsoft 공식 문서에서는 security.workspace.trust.enabled의 기본값이 true, security.workspace.trust.startupPrompt의 기본값이 never다. 따라서 새 폴더에서 신뢰 여부를 묻는 창이 먼저 나오지 않고 제한 모드 배너가 표시되는 동작도 정상이다. 예전 안내 화면과 다르다는 이유만으로 설정 오류라고 판단할 필요는 없다.
출처: [Microsoft VS Code 공식 문서 — Workspace Trust](https://code.visualstudio.com/docs/editing/workspaces/workspace-trust)
이 주제에서 판단에 도움이 되는 실제 데이터는 보안 사고 비율보다 현재 설정값과 적용 범위다. 근거 없는 안전 확률을 붙이기보다, 설치된 VS Code에서 어떤 폴더가 신뢰되고 어떤 실행 기능이 제한되는지 확인하는 편이 실용적이다.
VS Code 제한 모드가 뜨는 이유와 현재 기본 설정 실시간 확인하기
작업 영역 신뢰 설정을 확인하고 제한 모드 해제하기
제한 모드 해제는 현재 프로젝트에 실행 권한을 허용하는 결정이다. 작성자와 배포 경로가 확인되고 아래 점검 항목을 검토했다면, 작업 영역 신뢰 관리 화면에서 해당 폴더를 신뢰하도록 변경할 수 있다.
- 명령 팔레트를 연다. Windows와 Linux에서는
Ctrl+Shift+P, macOS에서는Shift+Command+P를 누른다. Workspaces: Manage Workspace Trust를 실행한다. 제한 모드 배너의 관리 링크나 상태 표시줄의 표시를 눌러도 같은 관리 화면에 접근할 수 있다.- 현재 경로와 신뢰 목록을 확인한다. 검토하려던 프로젝트 폴더가 맞는지, 더 넓은 상위 폴더가 등록돼 있는지 살펴본다.
- 검토한 폴더를 신뢰한다. 관리 화면의
Trust버튼으로 상태를 변경하고 필요한 작업을 이어간다.
실행 버튼이 막혔다는 이유만으로 전체 신뢰 기능을 끄는 것은 문제의 범위보다 큰 변경이다. security.workspace.trust.enabled를 수정하기 전에 현재 폴더에 대한 신뢰 설정만으로 해결되는지 확인하는 편이 관리하기 쉽다.
설정 화면의 문구는 표시 언어나 버전에 따라 조금씩 달라질 수 있다. 메뉴 위치가 헷갈릴 때는 명령 팔레트에서 위 명령을 검색하는 방식이 가장 명확하다.
외부 저장소 실행 전 확인할 설정과 스크립트
GitHub에서 복제하거나 ZIP 파일로 받은 프로젝트라면 소스 파일뿐 아니라 실행 경로도 살펴봐야 한다. 저장소를 공개했다는 사실과 로컬 환경에서 실행해도 된다는 판단은 별개다. 다음 순서로 확인하면 코드가 어떤 계기로 실행되는지 정리하기 쉽다.
먼저 .vscode 폴더의 작업과 설정 읽기
.vscode/tasks.json: 실행 명령, 인수, 작업 디렉터리, 연결된 선행 작업을 확인한다. 명령이 다른 스크립트를 호출한다면 그 파일까지 따라가서 읽는다..vscode/settings.json: 린터·포매터·언어 도구의 실행 파일 경로가 예상한 위치인지 확인한다. 프로젝트 안의 낯선 실행 파일을 가리키면 용도부터 확인한다..vscode/launch.json: 실행 대상, 인수, 환경 변수와preLaunchTask연결을 살펴본다. 디버깅 시작과 함께 별도 작업이 실행되는 구조인지 확인하는 데 도움이 된다..code-workspace파일: 포함된 폴더와 작업 영역 설정을 확인한다. 현재 보이는 프로젝트 외에 다른 경로가 함께 열리는지도 점검한다.
예를 들어 디버깅 대상 파일이 익숙해 보여도 preLaunchTask가 별도의 셸 스크립트와 연결돼 있다면 검토 범위는 그 스크립트까지 넓어진다. 실행 버튼의 이름보다 실제 호출되는 명령과 파일 경로를 기준으로 판단해야 한다.
터미널과 패키지 설치 명령의 실행 경로 확인하기
터미널을 열기 전에는 사용 중인 셸의 초기화 파일과 디렉터리별 자동 실행 도구 설정을 확인한다. .env 파일은 모든 셸이 자동으로 실행하는 파일은 아니지만, 셸 설정이나 추가 도구가 이를 읽어 처리하도록 구성돼 있을 수 있다. 파일 이름만 보고 안전 여부를 단정하지 않고 실제로 읽는 주체를 확인해야 한다.
이 글의 실무 점검 제안으로, Node.js 프로젝트라면 package.json의 scripts도 함께 읽어두는 것이 좋다. 안내된 설치·실행 명령이 어떤 작업을 호출하는지 확인하고, 내려받은 스크립트를 즉시 실행하는 명령은 원문과 다운로드 대상을 먼저 살펴본다. 실행 경로를 설명하기 어려운 부분이 남아 있다면 신뢰 전환을 보류할 근거가 된다.
제한 모드에서 작업 실행·디버깅·확장 기능이 달라지는 점
제한 모드에서는 편집 기능과 실행 기능을 구분해서 이해하면 혼란이 줄어든다. 소스 내용을 읽거나 수정할 수 있어도, 프로젝트가 지정한 도구를 실행하는 기능은 막히거나 일부만 동작할 수 있다. 확장 아이콘이나 명령이 사라졌다면 재설치에 앞서 신뢰 상태를 확인할 만하다.
Microsoft 공식 문서가 안내하는 제한 대상은 AI 에이전트, 터미널, 작업, 디버깅, 작업 영역 설정, 확장 기능이다. 모든 확장이 같은 방식으로 정지하는 것은 아니며, 제한 모드 지원 여부에 따라 비활성화되거나 일부 기능만 제공된다. 구체적인 제한 상태는 작업 영역 신뢰 관리 화면에서 확인할 수 있다.
확장 기능을 점검할 때는 관리 화면의 관련 링크나 확장 보기의 @workspaceUnsupported 필터를 활용할 수 있다. 적용되지 않는 작업 영역 설정은 @tag:requireTrustedWorkspace 필터로 살펴볼 수 있다. 어떤 기능이 왜 멈췄는지 파악한 뒤 필요한 권한을 판단하는 흐름이 효율적이다.
2026년 개발 환경에서 눈여겨볼 변화는 AI 에이전트까지 신뢰 판단에 포함된다는 점이다. 에이전트가 명령 실행과 코드 변경을 이어서 수행하는 작업 방식에서는, 프로젝트 검토가 끝나는 시점을 분명히 정해두는 것이 유용하다. 에이전트 실행 허용도 터미널이나 디버거 실행과 같은 검토 절차 안에서 판단하는 편이 일관적이다.
제한 모드에서 작업 실행·디버깅·확장 기능이 달라지는 점 지원하기
상위 폴더 신뢰 범위와 작업 영역 신뢰 취소 절차
신뢰 설정은 현재 폴더에만 직접 지정되는 것이 아니라 상위 폴더에서 상속될 수 있다. 예를 들어 C:\Projects를 신뢰하면 그 아래에 새로 내려받은 외부 저장소도 신뢰 범위에 들어간다. 여러 프로젝트를 편하게 열기 위해 넓은 경로를 등록했다면 이후 추가되는 폴더까지 함께 고려해야 한다.
실무적으로는 검토가 끝난 프로젝트와 확인 중인 프로젝트의 저장 위치를 분리하면 관리하기 편하다. 예를 들어 ReviewedProjects와 IncomingProjects를 나누고, 검토 중인 저장소는 개별 폴더 단위로 판단하는 방법이다. 이는 자동 보안 검사를 제공하는 방식이 아니라 신뢰 범위가 의도치 않게 넓어지는 일을 줄이기 위한 운영 제안이다.
Workspaces: Manage Workspace Trust를 다시 연다.Don't Trust버튼이 표시되면 이를 선택해 현재 작업 영역의 신뢰를 취소한다.Trusted Folders & Workspaces목록에서 등록된 경로를 확인하고 필요한 항목을 제거한다.- 버튼이 보이지 않으면 상위 폴더의 신뢰를 상속받는지 확인하고 해당 상위 경로의 등록을 검토한다.
- 상태 표시줄과 관리 화면에서 제한 모드 적용 여부를 다시 확인한다.
상위 경로를 목록에서 제거하면 그 경로를 통해 신뢰를 상속받던 다른 프로젝트에도 영향을 줄 수 있다. 계속 신뢰할 프로젝트가 있다면 해당 폴더를 개별 등록하는 방식으로 범위를 조정한다. 여러 폴더를 함께 여는 다중 루트 작업 영역에서는 신뢰하지 않는 폴더 추가로 전체 작업 영역이 제한 모드로 바뀔 수 있다는 점도 고려해야 한다.
상위 폴더 신뢰 범위와 작업 영역 신뢰 취소 절차 조회하기
제한 모드의 보안 경계와 실행 전 최종 판단
작업 영역 신뢰는 낯선 프로젝트를 검토하는 동안 자동 코드 실행을 줄이기 위한 보호 장치다. 신뢰 버튼을 눌렀다고 코드 검사가 완료되거나 저장소의 안전성이 인증되는 것은 아니다. 이미 실행된 코드의 동작을 되돌리는 기능으로 이해해서도 안 된다.
특히 확장 프로그램은 프로젝트와 별도로 검토해야 한다. 공식 문서는 악성 확장이 제한 모드를 무시하고 코드를 실행하는 것까지 Workspace Trust가 막을 수는 없다고 설명한다. 확장 설치 시에는 정확한 게시자 이름, 배포 경로와 유지보수 정보를 확인하고, 제한 모드 지원을 강제로 변경하기 전에 제한 이유를 살펴보는 편이 좋다.
전문적인 운영 관점에서 핵심은 신뢰 대상을 가능한 한 구체적으로 정하는 데 있다. ‘개발 폴더 전체’를 한 번에 허용하기보다 작성자, 실행 경로, 확장 게시자라는 서로 다른 판단 대상을 나눠 확인하면 검토 근거가 남는다. 기능이 막힐 때마다 설정을 넓혀 해제하는 습관보다 이후 문제의 원인을 추적하기도 쉽다.
실행 전에는 현재 경로와 신뢰 상속 여부를 확인하고, .vscode 설정에서 실제 명령까지 따라가면 된다. 셸의 자동 실행 구성과 확장 게시자까지 확인한 뒤 필요한 폴더만 신뢰하도록 변경한다. 판단이 끝나지 않았다면 제한 모드에서 파일 검토를 계속하는 선택도 충분히 자연스럽다.