Claude Code 설치, VS Code 확장 쓰면 따로 필요할까? (Windows)

VS Code 확장으로 Claude Code를 쓰는데, 설치 글마다 터미널에 따로 깔라고 해서 꼭 해야 하는지 망설여집니다. 예전에 깐 버전이 남아 있으면 확장은 최신인데 터미널에서만 오래된 Claude Code가 뜨고, 새 모델도 고를 수 없습니다.

 

제 Windows 11 PC를 확인해 보니 확장은 v2.1.301인데, 터미널의 claude는 예전에 npm으로 깐 v2.1.83이었습니다. 다 읽으면 따로 설치할지 정하고, 설치한다면 버전이 꼬이지 않게 까는 법까지 끝납니다.

확장만으로 되는 것, CLI가 있어야 되는 것

기능	VS Code 확장	CLI (터미널 claude)
명령어	일부 (/로 확인)	전부
MCP 서버 추가·관리	됨 (/mcp 창)	됨
체크포인트(되돌리기)	됨	됨
!로 셸 명령 바로 실행	안 됨	됨
Tab 자동 완성	안 됨	됨

공식 문서는 VS Code에서는 확장을 권장 방식으로 안내합니다. 확장 안에 채팅 패널용 Claude Code가 함께 들어 있어서, CLI를 따로 설치하지 않아도 바로 쓸 수 있습니다. 대화 기록도 확장과 CLI가 같이 씁니다.

 

다만 확장을 깔아도 터미널에서 claude 명령은 생기지 않습니다. 터미널에서 치려면 Claude Code 설치를 따로 해야 합니다.

Claude Code 설치가 따로 필요한 경우

• 터미널에서 claude --resume으로 확장 대화를 이어 열고 싶을 때
• claude doctor(설치 점검), claude update처럼 터미널 전용 명령을 쓸 때
• 확장에 없는 명령어나 ! 셸 실행이 필요할 때

이 중 해당하는 게 없으면 확장만으로 충분합니다. 저도 평소 확장으로 쓰다 보니 터미널 버전이 오래된 줄 몰랐습니다.

Windows Claude Code 설치

설치 전에 where.exe claude로 이미 깔린 게 있는지 먼저 보세요. 경로가 나오면 아래 '예전에 깐 버전' 순서부터 합니다.

 

준비물은 유료 요금제(Pro·Max·Team·Enterprise)나 Console 계정(API 결제 계정), 그리고 Windows 10(1809 이상) 또는 11입니다. PowerShell에서 공식 설치 명령 한 줄이면 됩니다.

irm https://claude.ai/install.ps1 | iex

설치가 끝나면 새 터미널을 열고 확인합니다.

claude --version
claude doctor

이 방식으로 깔면 %USERPROFILE%\.local\bin\claude.exe에 설치되고 백그라운드에서 자동으로 업데이트됩니다.

 

WinGet(winget install Anthropic.ClaudeCode)으로 깔면 자동 업데이트가 없어 winget upgrade Anthropic.ClaudeCode를 직접 해야 합니다. VS Code 통합 터미널(Ctrl + 백틱 키)에서 claude를 치면 변경 내용 비교(diff)와 오류·경고 정보가 VS Code와 자동으로 이어집니다.

예전에 깐 버전이 남아 있다면

증상: 확장은 최신인데 터미널 claude --version만 오래된 버전으로 나옴

원인: 예전에 npm으로 깐 Claude Code가 남아 있음. 업데이트는 켤 때와 켜져 있는 동안 확인하므로, 터미널에서 안 켜면 그대로 멈춰 있을 수 있음

해결: where.exe claude로 위치 확인 → npm uninstall -g @anthropic-ai/claude-code → 위 공식 설치 명령

공식 문서도 설치가 여러 개면 하나만 남기고, 공식 설치 명령으로 깐 것을 쓰라고 안내합니다. 버전이 오래되면 새 모델도 안 보입니다. Sonnet 5.5는 v2.1.284 이상이 필요해서 v2.1.83으로는 모델 변경 조건에 못 미칩니다.

확장·CLI 같이 쓸 때 궁금한 점

Q. 확장에서 하던 대화를 터미널에서 이어 쓸 수 있나요?
네. 터미널에서 claude --resume을 치면 목록이 열리고, 확장 대화를 골라 이어 갑니다.

 

Q. Claude Code 설치 후 'claude' is not recognized가 떠요.
먼저 새 터미널을 여세요. 그래도 같으면 설치 폴더가 PATH(명령을 찾는 경로)에 아직 안 들어간 경우라, PATH에 %USERPROFILE%\.local\bin이 있는지 확인하면 됩니다.

 

Q. 데스크톱 앱과는 뭐가 다른가요?
데스크톱 앱은 터미널 없이 Claude Code를 쓰는 별도 프로그램입니다. VS Code에서 코드를 고친다면 확장으로 충분합니다.

 

터미널을 쓸 일이 없다면 지금 상태 그대로가 맞고, 쓸 거라면 where.exe claude 한 번이 먼저입니다.

Claude Code 세팅 키트 (무료)

Claude Code를 쓴다면 프로젝트에 바로 넣어 쓸 수 있는 기본 세팅 묶음입니다. CLAUDE.md 템플릿, 비밀 파일·위험 명령 차단 훅, 권한 설정이 들어 있습니다.

GitHub에서 받기 →

관련 글

• Claude Code 필수 설정 가이드
• Claude Code 사용량 확인하는 법: 5시간·주간 한도와 줄이는 순서 5가지
• Claude Code 잘 쓰고 있나? 자가 진단 10문항과 읽을 글

설치 환경: Windows 11, VS Code + Claude Code 확장 v2.1.301, 터미널 npm 전역 설치 Claude Code v2.1.83(확인 시점), Claude Max