AI 루트
레벨 진단
← Claude Code

VS Code에서 Claude Code 쓰기 — 공식 확장 설치부터

기초약 12분5단계Claude Code 제대로 쓰기 코스 3/4

터미널이 낯설다면 VS Code 확장으로 Claude Code를 쓰는 게 편해요. 바뀔 내용을 나란히 비교해 보고, 파일을 @로 가리키고, 지난 대화를 목록에서 다시 여는 것까지 화면에서 할 수 있어요. 공식 문서는 VS Code에서는 이 확장을 권장합니다.

따라 하기

1단계 / 5

확장 설치하기

  1. 1VS Code(1.94.0 이상)에서 Mac은 Cmd+Shift+X, Windows는 Ctrl+Shift+X로 확장(Extensions) 화면을 엽니다.
  2. 2Claude Code를 검색해 제공자가 Anthropic인 확장을 설치합니다.
  3. Cursor 같은 VS Code 계열 편집기에서도 같은 확장을 쓸 수 있어요.
Claude Code 열기

이해를 돕는 예시 그림이에요. 실제 화면과 다를 수 있어요.

claude.ai/download
claude
Claude Desktop
Anthropic
여기를 클릭!
무료 · v1.x

누를 위치 Cmd/Ctrl+Shift+X›Claude Code 검색›Anthropic 확장 Install

팁 공식 문서(2026-09-15 확인): 확장이 안 보이면 VS Code를 다시 시작하거나 명령 팔레트에서 Developer: Reload Window를 실행하세요.

막히면 볼 것

자주 하는 실수 3가지
  1. 1옛 글의 'Claude - Anthropic' 같은 이름으로 찾음 — 공식 확장 이름은 'Claude Code'(제공: Anthropic)예요
  2. 2확장만 설치하고 VS Code 터미널에서 claude 명령을 기대함 — 확장은 채팅 패널용 CLI만 들어 있어요. 터미널에서도 쓰려면 따로 설치하세요(공식 문서)
  3. 3파일을 열지 않은 상태에서 편집기 위 Spark 아이콘을 찾음 — 이 아이콘은 파일이 열려 있을 때만 보여요. 왼쪽 활동 막대의 아이콘은 항상 보여요