VSCode에서 Dev Container를 사용하려고 할 때 가장 자주 막히는 지점이 있습니다. Command Palette에서 Dev Containers: Reopen in Container를 검색했는데 명령이 보이지 않거나, 메뉴에 컨테이너로 다시 열기 항목이 나타나지 않는 경우입니다.


이 문제는 대부분 Dev Containers 확장이 설치되지 않았거나, VSCode가 폴더 단위로 열려 있지 않거나, Docker Desktop이 실행되지 않았거나, Windows에서 WSL 연동이 꺼져 있을 때 발생합니다. 아래 순서대로 확인하면 원인을 빠르게 좁힐 수 있습니다.


VSCode Dev Container에서 Reopen in Container 명령이 보이지 않을 때 확인할 항목을 정리한 이미지

VSCode Dev Container 명령이 보이지 않을 때는 확장, 폴더, Docker, WSL 설정을 순서대로 확인하는 것이 좋습니다.


오류 메시지 원문과 증상

이 문제는 정확한 오류 메시지가 나오지 않고, 명령 자체가 보이지 않는 형태로 나타나는 경우가 많습니다. 대표적인 증상은 다음과 같습니다.


Dev Containers: Reopen in Container

위 명령을 Command Palette에서 검색했는데 나오지 않거나, 왼쪽 아래 원격 창 아이콘을 눌러도 Dev Containers 관련 메뉴가 보이지 않을 수 있습니다.


증상 가능한 원인 먼저 볼 것
명령 검색이 안 됨 Dev Containers 확장 미설치 또는 비활성화 확장 설치 상태
명령은 보이나 실행 실패 Docker Desktop 미실행 또는 Docker 연결 문제 docker version
WSL 프로젝트에서 안 됨 Docker Desktop WSL Integration 꺼짐 Docker Desktop 설정

언제 발생하는 오류인가

이 문제는 주로 VSCode를 새로 설치했거나, 맥북 또는 윈도우 개발환경을 새로 세팅했거나, 기존 프로젝트를 Dev Container로 열려고 할 때 발생합니다. 특히 Docker Desktop, VSCode 확장, WSL 설정이 서로 맞물려 있기 때문에 한 가지 설정만 빠져도 메뉴가 나타나지 않을 수 있습니다.


Dev Container 기본 개념이 아직 헷갈린다면 VSCode Dev Container 입문 2026 글을 먼저 보면 devcontainer.json, Docker, VSCode의 연결 구조를 이해하는 데 도움이 됩니다.


원인 3가지

원인 1. Dev Containers 확장이 설치되지 않았거나 비활성화됨

Reopen in Container 명령은 VSCode 기본 기능이 아니라 Dev Containers 확장에서 제공하는 명령입니다. 따라서 확장이 설치되어 있지 않거나, 현재 프로필에서 비활성화되어 있으면 명령이 보이지 않습니다.


VSCode 확장 탭에서 아래 확장을 검색합니다.


Dev Containers
ms-vscode-remote.remote-containers

설치되어 있는데도 안 보이면 확장이 Disable 상태인지 확인하고, VSCode를 완전히 종료한 뒤 다시 실행합니다.


원인 2. 파일 하나만 열고 있고 프로젝트 폴더를 열지 않음

Dev Container는 보통 프로젝트 폴더 단위로 동작합니다. 단일 파일만 열어 둔 상태에서는 컨테이너로 다시 열 대상이 명확하지 않아 관련 명령이 기대한 위치에 나타나지 않을 수 있습니다.


VSCode에서 파일 하나만 열었다면 먼저 프로젝트 폴더를 엽니다.


File > Open Folder...

터미널에서 프로젝트 폴더로 이동한 뒤 VSCode를 여는 방법도 사용할 수 있습니다.


cd your-project-folder
code .

원인 3. Docker Desktop이 실행되지 않았거나 WSL 연동이 꺼짐

Dev Container는 내부적으로 Docker를 사용합니다. Docker Desktop이 꺼져 있거나 Docker 엔진에 연결할 수 없으면 Dev Container 명령이 보이더라도 실행 단계에서 실패할 수 있습니다.


터미널에서 아래 명령어로 Docker가 정상 연결되는지 확인합니다.


docker version
docker ps

Windows에서 WSL 프로젝트를 열고 있다면 Docker Desktop의 Settings > Resources > WSL Integration에서 사용하는 Linux 배포판이 켜져 있는지 확인해야 합니다.


주의할 점
Docker 관련 명령이 실패한다고 해서 바로 Docker를 삭제하거나 초기화하지 않는 것이 좋습니다. 먼저 Docker Desktop 실행 상태, WSL 연동, 프로젝트 폴더 열기, Dev Containers 확장 설치 여부를 순서대로 확인해야 불필요한 재설치를 줄일 수 있습니다.


빠른 해결 방법

1단계. Command Palette에서 정확한 명령어 검색하기

먼저 VSCode에서 Command Palette를 엽니다.


macOS: Command + Shift + P
Windows/Linux: Ctrl + Shift + P

검색창에 아래 명령을 입력합니다.


Dev Containers: Reopen in Container

여기서 명령이 보이지 않으면 거의 대부분 확장 설치 또는 비활성화 문제부터 확인해야 합니다.


2단계. Dev Containers 확장 설치 확인

VSCode 확장 탭에서 Dev Containers를 검색해 설치합니다. 이미 설치되어 있다면 Disable 버튼이 보이는지 확인합니다. Disable 버튼이 보인다면 현재 활성화된 상태이고, Enable 버튼이 보인다면 비활성화된 상태입니다.


확장 설치 후에도 명령이 보이지 않으면 VSCode를 다시 시작합니다.


Developer: Reload Window

3단계. 프로젝트 폴더로 다시 열기

단일 파일이 아니라 프로젝트 폴더를 열어야 합니다. 폴더를 연 뒤 다시 Command Palette에서 Dev Containers: Reopen in Container를 검색합니다.


cd your-project-folder
code .

4단계. .devcontainer 폴더 확인

프로젝트 안에 Dev Container 설정이 없으면 템플릿을 선택해 새로 만들 수 있습니다. 일반적으로 아래 경로에 설정 파일이 있습니다.


.devcontainer/devcontainer.json

설정이 없다면 Command Palette에서 아래 명령을 검색해 기본 구성을 추가할 수 있습니다.


Dev Containers: Add Dev Container Configuration Files...

5단계. Docker Desktop 실행 상태 확인

Docker Desktop을 실행한 뒤 터미널에서 아래 명령어를 확인합니다.


docker version
docker ps

정상이라면 Docker 클라이언트와 서버 정보가 표시되고, 현재 실행 중인 컨테이너 목록이 나옵니다. Docker daemon 연결 오류가 나오면 Docker Desktop이 완전히 실행될 때까지 기다린 뒤 다시 시도합니다.


Windows / Mac / Linux 차이

환경 확인할 것 체크 방법
Windows Docker Desktop WSL Integration Settings > Resources > WSL Integration
macOS Docker Desktop 실행 상태 상단 메뉴바 Docker 아이콘 확인
Linux Docker Engine 권한 docker ps 실행 여부 확인

Windows에서 WSL 프로젝트를 열 때

Windows에서는 프로젝트가 Windows 파일 시스템에 있는지, WSL Linux 파일 시스템에 있는지에 따라 동작이 달라질 수 있습니다. WSL에서 개발한다면 WSL 터미널에서 프로젝트 폴더로 이동한 뒤 VSCode를 여는 방식이 안정적입니다.


wsl
cd ~/your-project
code .

macOS에서 Docker가 늦게 시작될 때

macOS에서는 Docker Desktop 실행 직후 Docker 엔진이 준비되기까지 시간이 걸릴 수 있습니다. VSCode를 먼저 열었더라도 Docker가 완전히 실행된 뒤 다시 Reload Window를 실행하면 명령이 정상 동작하는 경우가 있습니다.


Developer: Reload Window

Linux에서 권한 문제가 날 때

Linux에서는 Docker 명령 실행 권한 문제로 Dev Container 실행이 실패할 수 있습니다. 먼저 아래 명령어가 sudo 없이 실행되는지 확인합니다.


docker ps

권한 오류가 나면 현재 사용자와 Docker 그룹 설정을 확인해야 합니다. 회사 또는 교육용 PC라면 관리자 권한 정책 때문에 사용자가 직접 수정하지 못할 수도 있습니다.


재발 방지 설정

한 번 해결한 뒤 같은 문제가 반복된다면 아래 기준으로 개발환경을 정리해두는 것이 좋습니다.


재발을 줄이는 기준
VSCode는 프로젝트 폴더 단위로 열고, Dev Containers 확장을 설치한 상태로 유지하며, Docker Desktop이 먼저 실행된 뒤 컨테이너를 여는 순서가 안정적입니다. Windows WSL 환경에서는 Docker Desktop의 WSL Integration 설정까지 함께 확인해야 합니다.


항목 권장 기준 이유
VSCode 실행 파일이 아니라 폴더 열기 Dev Container 설정 탐지 기준이 명확해짐
Docker VSCode보다 먼저 실행 Docker daemon 연결 오류 감소
설정 파일 .devcontainer/devcontainer.json 유지 팀원 간 개발환경 차이 감소

관련 명령어 정리

명령어 용도 확인 결과
code . 현재 폴더를 VSCode로 열기 프로젝트 폴더 기준으로 열림
docker version Docker 연결 확인 Client와 Server 정보 확인
docker ps Docker 실행 상태 확인 실행 중인 컨테이너 목록 표시

VS Code Dev Containers 공식 문서에서 Reopen in Container 명령 사용 방법을 설명하는 화면

출처: Visual Studio Code 공식 문서. Dev Containers는 Command Palette에서 Reopen in Container 명령을 실행하는 흐름을 안내합니다.


공식 자료로 더 확인하기

Dev Container는 VSCode 확장, Docker, devcontainer.json 설정이 함께 작동하는 구조입니다. 설치 방법이나 명령 이름이 바뀔 수 있으므로, 문제가 반복된다면 공식 문서에서 현재 기준을 함께 확인하는 것이 좋습니다.


VS Code Dev Containers 공식 문서

Dev Containers 확장 설치, Reopen in Container 명령, Docker 기반 개발환경 구성 흐름을 확인할 수 있습니다.

VS Code Dev Containers 사용 방법 확인하기

Docker Desktop WSL 2 공식 문서

Windows에서 WSL 2 기반 Docker Desktop을 사용할 때 필요한 WSL Integration 설정과 기본 사용 흐름을 확인할 수 있습니다.

Docker Desktop WSL 2 연동 방법 확인하기

함께 보면 좋은 글

Dev Container 설정을 더 안정적으로 만들기
Reopen in Container 명령이 보이기 시작했다면 다음 단계는 프로젝트별 Python·Node 버전을 고정하는 것입니다. 팀 프로젝트에서 환경 차이를 줄이는 데 도움이 됩니다.
Dev Container에서 Python·Node 버전 고정하는 법

Docker Desktop 문제까지 함께 점검하기
Dev Container 실행 실패가 Docker Desktop 상태와 연결되어 있다면 설치, 권한, 리소스, 디스크 용량 문제를 함께 확인하는 것이 좋습니다.
Docker Desktop 설치 2026 권한·리소스·용량 문제 해결 체크리스트

자주 묻는 질문

Q1. Reopen in Container 명령이 아예 검색되지 않으면 무엇부터 확인해야 하나요?

가장 먼저 Dev Containers 확장이 설치되어 있는지 확인해야 합니다. 이 명령은 VSCode 기본 명령이 아니라 Dev Containers 확장에서 제공하는 명령입니다. 확장 설치 후에도 보이지 않으면 VSCode 창을 다시 불러오거나 완전히 종료한 뒤 다시 실행해보는 것이 좋습니다.


Q2. devcontainer.json 파일이 없어도 Reopen in Container를 사용할 수 있나요?

프로젝트에 devcontainer.json이 없다면 기존 설정으로 바로 열 수는 없습니다. 대신 Command Palette에서 Dev Containers 설정 파일 추가 명령을 실행해 기본 템플릿을 만들 수 있습니다. 이후 .devcontainer/devcontainer.json 파일이 생성되면 프로젝트를 컨테이너 환경으로 다시 열 수 있습니다.


Q3. Docker Desktop이 켜져 있는데도 Dev Container가 실행되지 않는 이유는 무엇인가요?

Docker Desktop 앱이 켜져 있어도 Docker 엔진이 아직 준비되지 않았거나, VSCode가 Docker에 연결하지 못하는 경우가 있습니다. 터미널에서 docker version과 docker ps를 실행해 서버 정보와 컨테이너 목록이 정상적으로 나오는지 확인해야 합니다. Windows WSL 환경에서는 WSL Integration 설정도 함께 봐야 합니다.


Q4. Windows에서 WSL 폴더와 일반 Windows 폴더 중 어디에서 열어야 하나요?

WSL 기반 개발을 한다면 WSL 터미널에서 프로젝트 폴더로 이동한 뒤 code . 명령으로 VSCode를 여는 방식이 안정적입니다. 이때 Docker Desktop의 WSL Integration에서 사용하는 배포판이 켜져 있어야 합니다. Windows 폴더에서 열 때와 WSL 폴더에서 열 때 경로와 권한 동작이 다를 수 있습니다.


Q5. VSCode를 재설치해야 해결되나요?

대부분은 재설치까지 필요하지 않습니다. 먼저 Dev Containers 확장 설치 상태, 프로젝트 폴더 열기, Docker Desktop 실행 상태, docker ps 명령 결과, WSL Integration 설정을 확인하는 것이 좋습니다. 그래도 해결되지 않을 때만 확장 재설치나 VSCode 설정 초기화를 검토하는 편이 안전합니다.


Reopen in Container 명령이 보이지 않을 때는 VSCode 확장, 프로젝트 폴더, Docker 실행 상태, WSL 연동 설정을 순서대로 확인하는 것이 가장 안전합니다.