Visual Studio Code 통합 터미널 안 열림 해결 가이드

기본 점검 순서

1. 1단계 — 증상을 먼저 나눕니다. Terminal > New Terminal이 비활성인지, 패널은 열리지만 셸이 시작되지 않는지, 특정 프로젝트에서만 실패하는지, PowerShell·Command Prompt·WSL 중 하나만 실패하는지, 종료 코드나 알림이 표시되는지 기록합니다. 모든 경우를 VS Code 재설치 문제로 보지 않습니다.^[1][3]
2. 2단계 — 현재 지원 환경과 설치 출처를 확인합니다. Microsoft 요구 사항 문서는 지원되는 64비트 Windows 클라이언트, Apple 보안 업데이트를 받는 macOS와 지정된 Linux 기준을 안내합니다. Windows 설치는 User·System·ZIP 방식이 다르고 ZIP은 수동 업데이트가 필요합니다. code.visualstudio.com의 공식 다운로드 또는 조직 배포 경로를 사용합니다.^[6][7][8]
3. 3단계 — 낯선 저장소를 연 직후 터미널이 막혔다면 창 아래 Restricted Mode 표시와 Workspace Trust를 확인합니다. 제한 모드에서는 작업 폴더 내용이 셸·작업·디버깅을 통해 자동 실행되는 위험을 줄이려고 터미널 시작이 기본 차단됩니다. 출처를 검토하지 않은 폴더를 문제 해결 목적으로 신뢰 상태로 바꾸지 않습니다.^[3][4]
4. 4단계 — Terminal: Select Default Profile에서 실제 설치된 셸을 선택합니다. Windows 기본 후보에는 PowerShell, Command Prompt, Git Bash나 WSL처럼 감지된 프로필이 나타날 수 있습니다. 목록에 없는 실행 파일 경로를 임의로 복사하기 전에 같은 셸을 Windows Terminal이나 별도 콘솔에서 직접 실행해 셸 자체가 정상인지 확인합니다.^[1][2]
5. 5단계 — 외부 콘솔에서는 되지만 VS Code에서만 실패하면 Settings에서 @modified 필터를 사용해 terminal.integrated.defaultProfile, profiles, cwd, env, inheritEnv, automationProfile과 splitCwd 변경을 점검합니다. 사용자 설정과 워크스페이스 설정을 구분하고, 전체 settings.json을 지우지 말고 변경한 터미널 항목을 기록한 뒤 한 항목씩 되돌립니다.^[1][2]
6. 6단계 — 특정 프로젝트에서만 실패하면 터미널이 시작할 작업 폴더가 실제로 존재하고 접근 가능한지 확인합니다. terminal.integrated.cwd, 워크스페이스 폴더, 네트워크·UNC 경로, 삭제되거나 이동한 프로젝트 경로를 나눠 봅니다. 신뢰하지 않는 저장소의 .vscode 설정이나 셸 초기화 파일을 실행해 확인하지 않습니다.^[1][3][4]
7. 7단계 — PowerShell·Git Bash·WSL 중 하나만 실패하면 해당 프로필의 path·args·env와 외부 실행 결과를 비교합니다. 기본 프로필을 다른 정상 셸로 잠시 바꿔 VS Code 터미널 호스트와 특정 셸 설정을 분리할 수 있지만, 실패한 셸의 설치·초기화 스크립트·배포 정책을 해결한 것으로 간주하지 않습니다.^[1][2]
8. 8단계 — 설정과 셸 자체가 정상인데도 실패하면 공식 문서가 안내하는 최신 VS Code·셸 상태와 종료 코드를 확인하고, 필요한 경우 trace logging으로 터미널 시작 기록을 수집합니다. 로그에는 셸 경로, 인수와 환경 변수가 포함될 수 있으므로 공개 게시 전에 사용자명·프로젝트 경로·토큰·서버 주소를 제거합니다.^[1]
9. 9단계 — 사용자 설치를 관리자 권한으로 실행하면 업데이트가 비활성화될 수 있고, 시스템 설치의 제품 내 업데이트에는 권한 상승이 필요합니다. 회사 장비에서 실행 파일 경로, 프로필 정책, AppLocker·보안 제품 또는 WSL 배포가 관리되는 경우 임의 재설치나 정책 우회 대신 IT 담당자에게 최소 재현 정보와 정제한 로그를 전달합니다.^[6]

증상별 결정 트리

Terminal > New Terminal이 차단됨 → 현재 창의 Restricted Mode 확인 → 저장소 출처·작업 파일 검토 → 신뢰를 판단할 수 없으면 제한 모드를 유지하고 별도 안전한 폴더에서 작업합니다.^[3][4]

셸 프로세스가 시작되지 않음 → 알림과 종료 코드 보존 → 같은 셸을 외부 콘솔에서 실행 → Terminal: Select Default Profile → profile path·args 비교로 이동합니다.^[1][2]

특정 워크스페이스만 실패 → 다른 빈 폴더에서 새 터미널 비교 → terminal.integrated.cwd와 워크스페이스 설정 → 이동·삭제된 경로와 네트워크 경로 접근을 확인합니다.^[1][3]

작업·디버깅에서만 실패 → 기본 프로필과 terminal.integrated.automationProfile을 분리해 확인합니다. 자동화용 셸은 일반 터미널과 다른 프로필을 사용할 수 있으므로 일반 셸 성공만으로 task 설정이 정상이라고 단정하지 않습니다.^[1][2]

현재 지원 조건과 공식 설치·업데이트 경로

2026-09-27 확인 당시 공식 요구 사항은 지원되는 64비트 Windows 클라이언트, Apple 보안 업데이트를 받는 macOS, Ubuntu Desktop 20.04·Debian 10·RHEL 8·Fedora 36을 플랫폼 기준으로 제시합니다. macOS는 일반적으로 최신 릴리스와 이전 두 버전 범위라고 설명합니다.^[7] 실제 배포 전에는 같은 공식 페이지의 현재 조건을 다시 확인합니다.

Windows 공식 설치 문서는 대부분의 개인 사용자에게 관리자 권한이 필요 없고 백그라운드 업데이트가 원활한 User setup을 권장합니다. System setup은 모든 사용자 범위와 관리자 권한이 필요하고, ZIP 배포는 릴리스마다 수동 업데이트해야 합니다.^[6] 조직 장비에서는 내부 패키지나 승인 경로가 우선할 수 있습니다.

공식 다운로드 페이지는 Windows 10·11용 User/System/ZIP, Linux deb·rpm·tar.gz·Snap, macOS용 Intel·Apple silicon·Universal 패키지를 구분합니다.^[8] 검색 광고의 설치 관리자나 출처 불명 포터블 묶음으로 터미널 문제를 해결하지 않습니다.

설정·로그·개인정보 안전 경계

terminal.integrated.env와 셸 초기화 파일에는 프록시, 개발 서버 주소, 인증서 경로 또는 비밀값 참조가 들어갈 수 있습니다. 진단을 위해 전체 설정·환경 변수를 공개하지 말고 영향을 받는 설정 이름과 마스킹한 값만 공유합니다.^[1][2]

Workspace Trust는 낯선 폴더의 자동 코드 실행 위험을 줄입니다. 터미널을 열기 위해 저장소를 즉시 신뢰하면 tasks, debugging, workspace settings와 extensions 제한도 함께 풀릴 수 있으므로 작성자와 내용을 확인한 뒤 결정합니다.^[3][4]

trace 로그는 셸 시작에 사용한 인수와 환경 정보를 보여 줄 수 있습니다.^[1] 공개 이슈에 첨부하기 전 사용자명, 홈·프로젝트 경로, 저장소 이름, 토큰, 호스트명, 고객 코드와 내부 네트워크 주소를 제거하고 원본은 조직 보관 정책에 맞춰 관리합니다.

대안과 중단 기준

VS Code 통합 터미널만 실패하고 셸 자체가 정상이라면 외부 Windows Terminal·PowerShell·Command Prompt 등 조직이 승인한 콘솔을 임시로 사용할 수 있습니다.^[1][6] 이는 workspace task·debug·shell integration과 같은 편집기 연동을 대체하지 않으므로 원인 분리용으로만 봅니다.

한 프로필만 실패하면 다른 감지된 셸로 비교해 특정 셸의 설치·초기화 문제인지 범위를 좁힐 수 있습니다. 각 프로필은 실행 파일 경로와 인수가 다르므로 PATH와 팀 표준 셸을 확인하고 임의로 기본값을 바꾸지 않습니다.^[1][2]

관리형 장비에서 프로필 설정이 되돌아오거나 실행 파일이 차단되고, AppLocker·보안 제품·원격 가상 데스크톱·공용 다중 사용자 환경이 관련되면 사용자 범위를 넘습니다. 정책 해제, 관리자 상시 실행, 비공식 설치로 우회하지 말고 조직 IT에 에스컬레이션합니다.^[6][7]

주의할 점과 운영 팁

• 터미널 메뉴 자체가 제한됨 → Restricted Mode와 폴더 출처 확인 → 신뢰 가능한 경우에만 Workspace Trust 결정 순서로 봅니다. 제한 모드는 오류가 아니라 코드 실행 경계일 수 있습니다.^[3][4]
• 패널은 열리지만 셸이 바로 종료됨 → 알림·종료 코드 기록 → 같은 셸을 외부 콘솔에서 실행 → 기본 프로필과 path·args 확인 순서로 좁힙니다.^[1][2]
• 특정 프로젝트만 실패 → 해당 창의 Workspace Trust → terminal.integrated.cwd → 프로젝트·UNC 경로 존재 여부 → 워크스페이스 설정 순서로 확인합니다.^[1][3]
• 한 셸만 실패 → 정상 셸로 임시 비교 → 실패 프로필의 실행 파일과 초기화 인수 확인 → 셸 설치 또는 조직 배포 담당으로 에스컬레이션합니다. 관리자 권한 상시 실행을 기본 해결책으로 삼지 않습니다.^[1][2][6]
• AppVeriq는 VS Code 설치 파일, settings.json, 셸 초기화 파일이나 trace 로그를 호스팅·미러링하지 않습니다. 공식 링크와 문서 도달 확인은 실제 설치·터미널 실행 시험, Microsoft의 인증이나 문제 해결 보증을 뜻하지 않습니다.

확인한 공식 출처

확인일: 2026-09-27. 링크 도달과 공개 문서 내용을 확인했으며, 설치·실행을 직접 시험했다는 뜻은 아닙니다.

1. [1] Visual Studio Code — Troubleshoot Terminal launch failures
2. [2] Visual Studio Code — Terminal Profiles
3. [3] Visual Studio Code — Workspace Trust
4. [4] Visual Studio Code — Terminal Basics
5. [5] Visual Studio Code — Profiles in Visual Studio Code
6. [6] Visual Studio Code — Installing Visual Studio Code on Windows
7. [7] Visual Studio Code — Requirements for Visual Studio Code
8. [8] Visual Studio Code — Download Visual Studio Code

관련 공식 다운로드 안내

관련 검색 주제

이 체크리스트와 함께 보면 좋은 검색 의도별 공식 다운로드 안내입니다.

자주 묻는 질문