VS Code Remote, Dev Containers, WSL

~14 min · remote, vscode, dev-containers, wsl

Level 0🌱 입문자

0 XP0/70 lessons0/11 achievements

0/120 XP to next level120 XP to go0% complete

코드가 있는 원격 환경에서 IDE와 Claude가 함께 움직여

Claude Code는 VS Code의 Remote-SSH, Dev Containers, Remote-WSL 환경을 따라가. VS Code가 원격에 연결되면 파일 경로와 터미널 명령, MCP 설정도 그 원격 기준으로 사용하니 에디터가 보는 코드와 에이전트가 만지는 코드가 어긋나지 않아.

Remote-SSH에서는 원격 터미널에서 claude를 실행하면 되고, Dev Container에서는 postCreateCommand로 Claude Code를 설치해. API 키는 ${localEnv:ANTHROPIC_API_KEY}처럼 로컬 환경에서 전달하고 container 설정 파일에 직접 쓰지 마.

WSL2도 같은 방식이야. 배포판 안에 Claude Code를 설치하고 Remote-WSL로 연결하면 경로 변환은 VS Code가 맡아. 로컬 MCP가 필요하면 Ports 패널로 해당 포트를 전달해 원격 세션에서 localhost로 접근할 수 있어.

직접 확인할 항목: ANTHROPIC_API_KEY.

Code

Dev Container에서 Claude Code 쓰기·json

// .devcontainer/devcontainer.json
{
  "name": "My Dev Container",
  "image": "mcr.microsoft.com/devcontainers/typescript-node:20",
  "postCreateCommand": "npm install -g @anthropic-ai/claude-code",
  "remoteEnv": {
    "ANTHROPIC_API_KEY": "${localEnv:ANTHROPIC_API_KEY}"
  },
  "customizations": {
    "vscode": {
      "extensions": ["anthropic.claude-code"]
    }
  }
}

다중 루트 작업 공간과 Remote·json

// myproject.code-workspace
{
  "folders": [
    { "path": "/home/ubuntu/backend" },
    { "path": "/home/ubuntu/frontend" },
    { "path": "/home/ubuntu/shared-lib" }
  ],
  "settings": {
    "claude.remote.includeAllRoots": true,
    "claude.remote.compactBeforeHandoff": true,
    "claude.remote.preferSSHConfig": true
  }
}

External links

Exercise

저장소에 .devcontainer/devcontainer.json을 만들어. postCreateCommand로 Claude Code를 설치하고 localEnv로 API 키를 전달해. 컨테이너에서 저장소를 다시 연 뒤 그 안에서 claude를 실행해. 키가 파일에 들어 있지 않아도 정상 작동하는지 확인해.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousSSH Direct — 어디서나 통하는 기본 설정 Next →제로 트러스트 보안 모델

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.