SpyBara
Go Premium

vs-code.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 253 additions and 195 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Wed 23 23:57 Fri 25 23:58

VS Code에서 Claude Code 사용하기

VS Code용 Claude Code 확장 프로그램을 설치하고 구성합니다. 인라인 diff, @-멘션, 계획 검토 및 키보드 단축키를 통해 AI 코딩 지원을 받습니다.

VS Code 편집기와 오른쪽에 열린 Claude Code 확장 프로그램 패널, Claude와의 대화를 표시

VS Code 확장 프로그램은 Claude Code를 위한 기본 그래픽 인터페이스를 제공하며, IDE에 직접 통합됩니다. 이것이 VS Code에서 Claude Code를 사용하는 권장 방법입니다.

확장 프로그램을 사용하면 Claude의 계획을 수락하기 전에 검토하고 편집할 수 있으며, 편집이 이루어질 때 자동으로 수락하고, 선택 항목에서 특정 줄 범위가 있는 파일을 @-멘션으로 표시하고, 대화 기록에 액세스하고, 별도의 탭이나 창에서 여러 대화를 열 수 있습니다.

필수 조건

설치하기 전에 다음을 확인하십시오:

  • VS Code 1.94.0 이상
  • Anthropic 계정: 모든 유료 Claude 구독(Pro, Max, Team 또는 Enterprise) 또는 Claude Console 계정이 작동하며, API 키가 필요하지 않습니다. 확장 프로그램을 처음 열 때 이 계정으로 로그인합니다. Amazon Bedrock이나 Google Cloud의 Agent Platform과 같은 타사 공급자를 통해 Claude에 액세스하는 경우 설정 지침은 타사 공급자 사용을 참조하십시오.

확장 프로그램 설치

IDE에 대한 링크를 클릭하여 직접 설치합니다:

또는 VS Code에서 Cmd+Shift+X(Mac) 또는 Ctrl+Shift+X(Windows/Linux)를 눌러 확장 프로그램 보기를 열고, "Claude Code"를 검색한 후 설치를 클릭합니다.

확장 프로그램은 Devin Desktop 또는 Kiro와 같은 다른 VS Code 포크에도 설치됩니다. 편집기의 확장 프로그램 보기에서 "Claude Code"를 검색하거나 Open VSX 레지스트리에서 설치합니다. 편집기에서 확장 프로그램을 설치할 수 없는 경우 CLI를 설치하고 통합 터미널에서 claude를 실행합니다. CLI는 모든 터미널에서 작동합니다.

시작하기

설치 후 VS Code 인터페이스를 통해 Claude Code를 사용할 수 있습니다.

1

Claude Code 패널 열기

VS Code 전체에서 Spark 아이콘은 Claude Code를 나타냅니다. <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Spark icon" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

Claude를 여는 가장 빠른 방법은 편집기 도구 모음(편집기의 오른쪽 상단 모서리)에서 Spark 아이콘을 클릭하는 것입니다. 이 아이콘은 파일을 열었을 때만 나타납니다.

VS Code 편집기에서 편집기 도구 모음의 Spark 아이콘을 보여주는 화면

Claude Code를 여는 다른 방법:

  • 활동 표시줄: 왼쪽 사이드바의 Spark 아이콘을 클릭하여 세션 목록을 엽니다. 세션을 클릭하여 전체 편집기 탭으로 열거나 새로운 세션을 시작할 수 있습니다. 이 아이콘은 항상 활동 표시줄에 표시됩니다.
  • 명령 팔레트: Cmd+Shift+P(Mac) 또는 Ctrl+Shift+P(Windows/Linux)를 누르고 "Claude Code"를 입력한 후 "새 탭에서 열기"와 같은 옵션을 선택합니다.
  • 상태 표시줄: preferredLocation을 sidebar로 설정했거나 Claude Code: 사이드 바에서 열기로 Claude를 열었다면 창의 오른쪽 아래 모서리에서 ✱ Claude Code를 클릭합니다. 파일을 열지 않았을 때도 작동합니다.

Claude 패널을 드래그하여 VS Code의 어디든지 재배치할 수 있습니다. 자세한 내용은 워크플로우 사용자 정의를 참조하세요.

2

로그인

처음 패널을 열면 로그인 화면이 나타납니다. 로그인을 클릭하고 브라우저에서 인증을 완료합니다.

나중에 로그인하지 않음 · /login을 실행하세요가 표시되면 확장 프로그램이 자동으로 로그인 화면을 다시 엽니다. 표시되지 않으면 명령 팔레트에서 개발자: 창 다시 로드로 창을 다시 로드합니다.

셸에 ANTHROPIC_API_KEY가 설정되어 있지만 여전히 로그인 프롬프트가 표시되면 VS Code가 셸 환경을 상속하지 못했을 수 있습니다. 터미널에서 code .로 VS Code를 실행하여 환경 변수를 상속하거나 Claude 계정으로 로그인합니다.

로그인 후 Learn Claude Code 체크리스트가 나타납니다. 보여주기를 클릭하여 각 항목을 진행하거나 X로 닫습니다. 나중에 다시 열려면 VS Code 설정의 확장 프로그램 → Claude Code에서 온보딩 숨기기를 선택 해제합니다.

3

프롬프트 보내기

Claude에게 코드나 파일을 도와달라고 요청합니다. 작동 방식 설명, 문제 디버깅 또는 변경 사항 만들기 등이 있습니다.

파일의 특정 줄에 대해 묻는 예시입니다.

Python 파일에서 2-3줄이 선택되고 Claude Code 패널에 @-멘션 참조가 있는 해당 줄에 대한 질문이 표시된 VS Code 편집기
4

변경 사항 검토

표시되는 내용은 프롬프트 상자 아래에 표시된 권한 모드에 따라 다릅니다.

  • 자동 또는 자동 편집 모드에서 Claude는 대부분의 파일을 워크스페이스에서 묻지 않고 편집합니다.
  • 수동 모드에서 Claude가 파일을 편집하려고 하면 원본과 제안된 변경 사항의 나란히 비교를 표시한 후 권한을 요청합니다. 수락, 거부 또는 Claude에게 대신 수행할 작업을 알릴 수 있습니다. 수락하기 전에 diff 보기에서 제안된 콘텐츠를 직접 편집하면 Claude는 수정되었다는 것을 알려져 파일이 원본 제안과 일치한다고 가정하지 않습니다.
Claude의 제안된 변경 사항의 diff를 표시하고 편집을 수행할지 여부를 묻는 권한 프롬프트가 있는 VS Code

Claude Code로 할 수 있는 작업에 대한 더 많은 아이디어는 일반적인 워크플로우를 참조하세요.

프롬프트 상자 사용

프롬프트 상자는 여러 기능을 지원합니다:

  • 권한 모드: 프롬프트 상자 하단의 모드 표시기를 클릭하여 권한 모드를 전환합니다. Pro, Max, Team 플랜에서는 Auto가 기본 시작 권한 모드입니다. 확장 프로그램이 시작 권한 모드를 선택하는 방법과 표시기가 제공하는 모든 권한 모드를 참조하세요.
    • Auto: 분류기가 사용자에게 묻는 대신 대부분의 작업을 검토합니다. 자동 모드에서 검토하고 차단하는 항목을 참조하세요.
    • Manual: Claude가 파일 편집 및 대부분의 셸 명령 전에 권한을 요청합니다.
    • Plan: Claude가 수행할 작업을 설명하고 변경 작업을 시작하기 전에 승인을 기다립니다. VS Code는 자동으로 계획을 전체 Markdown 문서로 열어서 Claude가 시작하기 전에 피드백을 제공하기 위해 인라인 주석을 추가할 수 있습니다.
    • Edit automatically: Claude가 묻지 않고 편집합니다.
  • 모델: 명령 메뉴에서 **Switch model…**을 선택하여 세션 중간에 모델을 변경합니다. 프롬프트 상자 하단의 모델 이름을 클릭하여 동일한 선택기를 열 수도 있습니다. 현재 모델이 노력 수준을 지원하는 경우 선택기에 Effort 행도 표시됩니다. 모델 이름 버튼과 Effort 행에는 Claude Code v2.1.257 이상이 필요합니다.
  • 명령 메뉴: /를 클릭하거나 /를 입력하여 명령 메뉴를 엽니다. 옵션에는 파일 첨부, 모델 전환, 확장 사고 토글이 포함됩니다. Customize 섹션은 MCP 서버, slash 명령, 출력 스타일, 훅, 메모리, 권한 및 플러그인에 대한 액세스를 제공합니다. 터미널 아이콘이 있는 항목은 통합 터미널에서 열립니다.

    • /usage 또는 /remote-control과 같은 명령을 찾아보려면 Customize 섹션에서 Slash commands를 선택합니다. 대화 상자에 필터 상자가 있는 목록이 표시됩니다. 하나를 선택하여 실행합니다. 프롬프트 상자에서 /를 입력하면 여전히 명령을 인라인으로 제안합니다. Claude Code v2.1.257 이상이 필요합니다.

    • Customize 섹션에서 Output styles를 선택하여 사용자 정의 스타일을 포함한 출력 스타일을 선택합니다. Claude Code v2.1.257 이상이 필요합니다.

      대신 사용자 정의 스타일을 만들려면 Output styles 메뉴에서 Build a custom style을 선택합니다. Claude Code는 프로젝트 또는 사용자 수준에서 스타일 파일을 작성합니다. Claude Code v2.1.261 이상이 필요합니다.

    • Settings 섹션에는 Enable Remote Control for all sessions이 포함되어 있으며, 이는 remoteControlAtStartup을 설정하여 새 대화형 세션이 Remote Control에 자동으로 연결되는지 제어합니다. Claude Code v2.1.203 이상이 필요합니다.

      VS Code 창에서 토글을 켜거나 끌 때 변경 사항은 그 이후에 시작하는 세션뿐만 아니라 해당 VS Code 창에서 이미 열려 있는 세션에 적용됩니다. 토글을 끄면 열려 있는 세션이 연결 해제됩니다. Claude Code v2.1.261 이상에서는 변경 사항이 다른 VS Code 창에서 열려 있는 세션에도 도달합니다.

    • Settings 섹션에는 또한 Focus view가 포함되어 있으며, 이는 도구 호출, 도구 결과 및 사고를 확장 가능한 행 뒤에 숨기고 프롬프트와 Claude의 응답을 남깁니다. Claude의 최신 할 일 목록은 계속 표시되며, Claude가 묻는 보류 중인 질문의 텍스트도 표시됩니다. 이는 Claude Code v2.1.225 이상이 필요합니다. 여기서 토글하거나, Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux)를 사용하거나, Command Palette에서 Claude Code: Toggle Focus view를 사용하여 토글합니다. 변경 사항은 모든 열려 있는 세션에 적용되고 세션 전체에서 유지됩니다. Claude Code v2.1.221 이상이 필요합니다.

    • 버그를 보고하려면 메뉴 하단의 Report a problem을 클릭하거나 /bug 또는 /feedback을 입력하고 선택적으로 보고서를 미리 채우는 설명을 입력합니다. 보고서를 제출하고 1차 연결에서 Anthropic에 로그인한 경우 Claude Code는 이를 Anthropic에 보냅니다. 3차 공급자에서 또는 Anthropic 자격 증명 없이 대화 상자가 여전히 열리지만 제출하면 오류가 표시되고 아무것도 전송되지 않습니다. CLI의 /bug와 달리 확장 프로그램은 로컬 아카이브를 작성하지 않습니다. Claude Code v2.1.229 이상이 필요합니다.

  • Side questions: /btw 다음에 질문을 입력하여 대화에 추가하지 않고 세션에 대해 질문합니다. 답변은 채팅 옆의 패널에서 열리며, 여기서 후속 질문을 할 수 있습니다. 스레드는 창 다시 로드를 유지합니다. Claude Code는 최신 20개 교환을 유지하고 Claude Code가 안전하게 보존 기간을 결정할 수 있는 한 cleanupPeriodDays 일정에 따라 저장된 스레드를 만료합니다. 스레드를 지우려면 패널의 휴지통 아이콘을 클릭합니다. Claude Code v2.1.227 이상이 필요합니다.
  • Context indicator: 프롬프트 상자는 Claude의 컨텍스트 윈도우를 얼마나 사용하고 있는지 보여줍니다. Claude는 필요할 때 자동으로 압축하거나 /compact를 수동으로 실행할 수 있습니다.
  • Extended thinking: Claude가 복잡한 문제를 추론하는 데 더 많은 시간을 소비할 수 있게 합니다. 명령 메뉴(/)를 통해 토글합니다. Claude의 추론은 대화에 축소된 블록으로 나타납니다. 블록을 클릭하여 읽거나 Ctrl+O를 눌러 세션의 모든 사고 블록을 확장하거나 축소합니다. 자세한 내용은 Extended thinking을 참조하세요.
  • Multi-line input: Shift+Enter를 눌러 보내지 않고 새 줄을 추가합니다. 이는 질문 대화의 "Other" 자유 텍스트 입력에서도 작동합니다.

참조 파일 및 폴더

@-멘션을 사용하여 특정 파일 또는 폴더에 대한 컨텍스트를 Claude에 제공합니다. @ 다음에 파일 또는 폴더 이름을 입력하면 Claude가 해당 콘텐츠를 읽고 이에 대해 질문하거나 변경할 수 있습니다. Claude Code는 퍼지 매칭을 지원하므로 부분 이름을 입력하여 필요한 항목을 찾을 수 있습니다:

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

큰 PDF의 경우 전체 파일 대신 특정 페이지를 읽도록 Claude에 요청할 수 있습니다. 단일 페이지, 1-10페이지와 같은 범위 또는 3페이지 이상과 같은 개방형 범위입니다.

편집기에서 텍스트를 선택하면 Claude가 강조 표시된 코드를 자동으로 볼 수 있습니다. 프롬프트 상자 바닥글은 선택된 줄 수를 표시합니다. Option+K (Mac) / Alt+K (Windows/Linux)를 눌러 파일 경로 및 줄 번호가 있는 @-멘션을 삽입합니다 (예: @app.ts#5-10). 선택 표시기를 클릭하여 Claude가 강조 표시된 텍스트를 볼 수 있는지 여부를 토글합니다. 눈-슬래시 아이콘은 선택이 Claude에서 숨겨져 있음을 의미합니다.

파일을 프롬프트 상자로 드래그할 때 Shift를 누르고 있으면 첨부 파일로 추가할 수 있습니다. 첨부 파일의 X를 클릭하여 컨텍스트에서 제거합니다.

과거 대화 재개

Claude Code 패널 상단의 Session history 버튼을 클릭하여 대화 기록에 액세스합니다. 키워드로 검색하거나 시간별로 찾아볼 수 있습니다. 모든 대화를 클릭하여 전체 메시지 기록으로 재개합니다. 세션 재개에 대한 자세한 내용은 Manage sessions를 참조하세요.

새 세션은 첫 번째 메시지를 기반으로 AI가 생성한 제목을 받습니다. 세션 위에 마우스를 올려 이름 바꾸기 및 보관 작업을 표시합니다. 설명적인 제목을 지정하도록 이름을 바꾸거나 목록 하단의 Archived sessions 그룹으로 이동하도록 보관합니다.

보관된 세션을 복원하려면 Archived sessions을 확장하고 Unarchive session을 클릭합니다. v2.1.257 이전에는 작업이 Delete session이었으며, 이는 복원할 방법이 없는 세션을 숨겼습니다. 그 후 삭제한 세션은 업그레이드 후 Archived sessions 아래에 나타납니다.

재개한 대화가 계획 모드에서 끝난 경우 Claude Code는 계획 모드를 복원합니다. Claude Code v2.1.246 이상이 필요합니다. Claude Code는 두 가지 경우에 복원하지 않습니다:

  • 확장 프로그램이 claudeCode.initialPermissionMode에서 또는 이전 대화에서 이월되는 선택에서 시작 권한 모드를 선택합니다
  • claudeCode.claudeProcessWrapper가 구성되어 있습니다

Claude.ai에서 클라우드 세션 재개

웹에서 Claude Code를 사용하는 경우 VS Code에서 직접 해당 클라우드 세션을 재개할 수 있습니다. 이는 Anthropic Console이 아닌 Claude.ai Subscription으로 로그인해야 합니다.

1

Open session history

Claude Code 패널 상단의 Session history 버튼을 클릭합니다.

2

Select the Web tab

대화 상자에 두 개의 탭이 표시됩니다: Local과 Web. Web을 클릭하여 claude.ai의 세션을 봅니다.

3

Select a session to resume

클라우드 세션을 찾아보거나 검색합니다. 모든 세션을 클릭하여 다운로드하고 로컬에서 대화를 계속합니다.

계정 및 사용량 확인

/usage를 실행하여 Account & usage 대화를 엽니다. 대화에는 claude.ai 로그인이 필요하므로 3차 공급자에서 제공되지 않습니다. 로그인한 계정, 플랜 및 현재 세션과 주의 사용량 막대를 표시합니다. 각 막대는 제한이 재설정될 때까지의 시간을 표시합니다.

대화는 또한 플랜 제한에 기여하는 항목을 분류합니다. 캐시 미스, 긴 컨텍스트, 서브에이전트 집약적 또는 고도로 병렬 세션과 같이 최근 사용량의 10% 이상을 차지하는 동작에 플래그를 지정하며, 각각 이를 줄이기 위한 팁이 있습니다. Attribution 테이블은 각 스킬, 서브에이전트, 플러그인 및 MCP 서버에서 얼마나 많은 사용량이 나왔는지 보여줍니다. Claude Code v2.1.174 이상이 필요합니다.

Day와 Week 토글을 사용하여 지난 24시간과 지난 7일 사이를 전환합니다. 수치는 대략적이며 이 컴퓨터의 로컬 세션에서 계산되므로 다른 장치 또는 claude.ai의 사용량은 포함되지 않습니다. 사용량 추적 및 감소에 대한 자세한 내용은 Track your costs를 참조하세요.

워크플로우 사용자 정의

Claude 패널의 위치를 변경하고, 여러 대화를 실행하며, 세션 목록을 그룹으로 정렬하거나 터미널 모드로 전환할 수 있습니다.

Claude가 위치할 곳 선택

Claude 패널을 드래그하여 VS Code의 어느 곳이든 위치를 변경할 수 있습니다. 패널의 탭이나 제목 표시줄을 잡고 다음 위치로 드래그합니다:

  • 보조 사이드바: 창의 오른쪽입니다. 코드를 작성하는 동안 Claude를 계속 볼 수 있습니다.
  • 주 사이드바: 탐색기, 검색 등의 아이콘이 있는 왼쪽 사이드바입니다.
  • 편집기 영역: Claude를 파일과 함께 탭으로 엽니다. 부수적인 작업에 유용합니다.

여러 대화 실행

명령 팔레트에서 새 탭에서 열기 또는 새 창에서 열기를 사용하여 추가 대화를 시작합니다. 각 대화는 자체 기록과 컨텍스트를 유지하므로 여러 작업을 병렬로 진행할 수 있습니다.

탭을 사용할 때, 스파크 아이콘의 작은 색상 점은 상태를 나타냅니다: 파란색은 권한 요청이 대기 중임을 의미하고, 주황색은 탭이 숨겨진 동안 Claude가 완료되었음을 의미합니다.

세션을 그룹으로 정렬

활동 표시줄의 세션 목록에서 관련 세션을 명명된 축소 가능한 그룹으로 수집할 수 있습니다. Claude Code v2.1.229 이상이 필요합니다.

  • 세션 그룹화 또는 그룹 해제: 세션을 마우스 오른쪽 버튼으로 클릭하여 그룹을 만들거나, 기존 그룹으로 이동하거나, 그룹에서 제거합니다. 각 세션은 한 번에 하나의 그룹에만 속하므로, 다른 그룹으로 이동하면 첫 번째 그룹에서 제거됩니다.
  • 여러 세션을 한 번에 이동: Cmd-클릭(Mac) / Ctrl-클릭(Windows/Linux)으로 각 세션을 선택하거나, Shift-클릭으로 범위를 선택한 후 선택 항목을 마우스 오른쪽 버튼으로 클릭합니다.
  • 탭에서 세션 그룹화: 명령 팔레트에서 Claude Code: Add Session Tab to Group을 실행하거나, 세션의 편집기 탭을 마우스 오른쪽 버튼으로 클릭한 후 그룹을 선택하거나 만듭니다. Claude Code v2.1.257 이상이 필요합니다.
  • 그룹 이름 바꾸기 또는 삭제: 그룹 헤더를 마우스 오른쪽 버튼으로 클릭합니다. 그룹을 삭제하면 그룹만 제거되고 해당 세션은 그룹화되지 않은 목록으로 돌아갑니다.

확장 프로그램은 작업 영역 폴더별로 그룹을 저장하므로, 창을 다시 로드해도 유지되며 같은 폴더를 여는 모든 창에 표시됩니다. 목록을 검색할 때 확장 프로그램은 모든 그룹에서 일치하는 항목을 하나의 평면 목록으로 표시합니다.

터미널 모드로 전환

기본적으로 확장 프로그램은 그래픽 채팅 패널을 엽니다. CLI 스타일 인터페이스를 선호하는 경우 터미널 사용 설정을 열고 확인란을 선택합니다.

VS Code 설정(Mac에서 Cmd+, 또는 Windows/Linux에서 Ctrl+,)을 열고, 확장 프로그램 → Claude Code로 이동한 후 터미널 사용을 선택할 수도 있습니다.

플러그인 관리

VS Code 확장 프로그램에는 플러그인을 설치하고 관리하기 위한 그래픽 인터페이스가 포함되어 있습니다. 프롬프트 상자에 /plugins를 입력하여 플러그인 관리 인터페이스를 엽니다.

플러그인 설치

플러그인 대화 상자에는 플러그인 및 마켓플레이스 두 개의 탭이 표시됩니다.

플러그인 탭에서:

  • 설치된 플러그인은 상단에 표시되며 토글 스위치로 활성화 또는 비활성화할 수 있습니다
  • 사용 가능한 플러그인은 구성된 마켓플레이스에서 아래에 표시됩니다
  • 이름 또는 설명으로 플러그인을 필터링하려면 검색을 사용합니다
  • 사용 가능한 플러그인에서 설치를 클릭합니다

플러그인을 설치할 때 설치 범위를 선택합니다:

  • 사용자용으로 설치: 모든 프로젝트에서 사용 가능(사용자 범위)
  • 이 프로젝트용으로 설치: 프로젝트 협력자와 공유(프로젝트 범위)
  • 로컬로 설치: 이 저장소에서만 사용자용(로컬 범위)

마켓플레이스 관리

마켓플레이스 탭으로 전환하여 플러그인 소스를 추가하거나 제거합니다:

  • GitHub 저장소, URL 또는 로컬 경로를 입력하여 새 마켓플레이스를 추가합니다
  • 새로고침 아이콘을 클릭하여 마켓플레이스의 플러그인 목록을 업데이트합니다
  • 휴지통 아이콘을 클릭하여 마켓플레이스를 제거합니다

변경 사항을 적용한 후 배너가 표시되어 Claude Code를 다시 시작하라는 메시지를 표시합니다.

플러그인 시스템에 대한 자세한 내용은 플러그인 및 플러그인 마켓플레이스를 참조하십시오.

Chrome으로 브라우저 작업 자동화

Claude를 Chrome 브라우저에 연결하여 웹 앱을 테스트하고, 콘솔 로그로 디버깅하며, VS Code를 떠나지 않고 브라우저 워크플로우를 자동화합니다. 이를 위해서는 Claude in Chrome 확장 프로그램 버전 1.0.36 이상이 필요합니다.

프롬프트 상자에 @browser를 입력한 후 Claude가 수행할 작업을 입력합니다:

@browser go to localhost:3000 and check the console for errors

첨부 메뉴를 열어 새 탭 열기 또는 페이지 콘텐츠 읽기와 같은 특정 브라우저 도구를 선택할 수도 있습니다.

Claude는 브라우저 작업을 위해 새 탭을 열고 브라우저의 로그인 상태를 공유하므로, 이미 로그인한 모든 사이트에 액세스할 수 있습니다.

설정 지침, 전체 기능 목록 및 문제 해결에 대해서는 Claude Code를 Chrome과 함께 사용을 참조합니다.

VS Code 명령어 및 단축키

명령 팔레트를 열고(Mac에서 Cmd+Shift+P 또는 Windows/Linux에서 Ctrl+Shift+P) "Claude Code"를 입력하면 Claude Code 확장 프로그램의 모든 사용 가능한 VS Code 명령어를 볼 수 있습니다.

일부 단축키는 어느 패널이 "포커스"되어 있는지(키보드 입력을 받고 있는지)에 따라 달라집니다. 커서가 코드 파일에 있으면 편집기가 포커스됩니다. 커서가 Claude의 프롬프트 상자에 있으면 Claude가 포커스됩니다. Cmd+Esc / Ctrl+Esc를 사용하여 둘 사이를 전환합니다.

명령어 단축키 설명
Focus Input Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) 편집기와 Claude 사이의 포커스 전환
Open in Side Bar - Claude를 사이드바에서 열기
Open in Terminal - Claude를 터미널 모드에서 열기
Open in New Tab Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) 새 대화를 편집기 탭으로 열기
Open in New Window - 새 대화를 별도 창에서 열기
New Conversation Cmd+N (Mac) / Ctrl+N (Windows/Linux) 새 대화 시작. Claude가 포커스되어 있고 enableNewConversationShortcut이 true로 설정되어 있어야 함
Reopen Closed Session Cmd+Shift+T (Mac) / Ctrl+Shift+T (Windows/Linux) 가장 최근에 닫은 Claude 세션 탭을 다시 열기. 마지막으로 닫은 탭이 Claude 세션이 아닌 경우 VS Code의 일반 닫힌 편집기 다시 열기로 폴스루됨. enableReopenClosedSessionShortcut으로 비활성화
Insert @-Mention Reference Option+K (Mac) / Alt+K (Windows/Linux) 현재 파일 및 선택 항목에 대한 참조 삽입(편집기가 포커스되어 있어야 함)
Toggle Focus view Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux) 대화에서 도구 활동 숨기기 또는 표시. Claude 패널 또는 사이드바가 표시되는 동안 작동. Claude Code v2.1.221 이상 필요
Rename Session Tab - 활성 Claude 탭의 세션 이름 바꾸기. 명령어는 탭의 우클릭 메뉴에도 나타남. Claude Code v2.1.257 이상 필요
Add Session Tab to Group - 활성 Claude 탭의 세션을 선택하거나 만드는 세션 그룹에 추가. 명령어는 탭의 우클릭 메뉴에도 나타남. Claude Code v2.1.257 이상 필요
Mark Session as Unread - 활성 Claude 탭의 세션을 세션 목록에서 읽지 않음으로 표시. 명령어는 탭의 우클릭 메뉴에도 나타남. Claude Code v2.1.257 이상 필요
Show Logs - 확장 프로그램 디버그 로그 보기
Logout - Anthropic 계정에서 로그아웃

다른 도구에서 VS Code 탭 시작

확장 프로그램은 vscode://anthropic.claude-code/open에서 URI 핸들러를 등록합니다. 이를 사용하여 자신의 도구(셸 별칭, 브라우저 북마클릿 또는 URL을 열 수 있는 모든 스크립트)에서 새 Claude Code 탭을 열 수 있습니다. VS Code가 아직 실행 중이 아니면 URL을 열면 먼저 실행됩니다. VS Code가 이미 실행 중이면 URL은 현재 포커스된 창에서 열립니다.

운영 체제의 URL 오프너로 핸들러를 호출합니다.

open "vscode://anthropic.claude-code/open"

핸들러는 두 개의 선택적 쿼리 매개변수를 허용합니다:

매개변수 설명
prompt 프롬프트 상자에 미리 채울 텍스트. URL 인코딩되어야 함. 프롬프트는 미리 채워지지만 자동으로 제출되지 않음.
session 새 대화를 시작하는 대신 재개할 세션 ID. 세션은 VS Code에서 현재 열려 있는 작업 영역에 속해야 함. 세션을 찾을 수 없으면 새 대화가 시작됨. 세션이 이미 탭에서 열려 있으면 해당 탭이 포커스됨. 프로그래밍 방식으로 세션 ID를 캡처하려면 대화 계속하기를 참조하십시오.

예를 들어 "review my changes"로 미리 채워진 탭을 열려면:

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

VS Code 탭 대신 터미널 세션을 시작하려면 CLI의 claude-cli:// 핸들러를 사용합니다. 링크에서 세션 시작하기를 참조하십시오.

설정 구성

확장 프로그램에는 두 가지 유형의 설정이 있습니다:

  • VS Code의 확장 프로그램 설정: VS Code 내에서 확장 프로그램의 동작을 제어합니다. Cmd+,(Mac) 또는 Ctrl+,(Windows/Linux)로 열고, Extensions → Claude Code로 이동합니다. /를 입력하고 General Config를 선택하여 설정을 열 수도 있습니다.
  • ~/.claude/settings.json의 Claude Code 설정: 확장 프로그램과 CLI 간에 공유됩니다. 허용된 명령, 환경 변수, hooks 및 MCP 서버에 사용합니다. Pro, Max 및 Team 플랜에서는 권한 모드 대화가 시작되는 입력 중 하나이기도 합니다. 권한 모드 전환에서 순서를 나열합니다. 자세한 내용은 설정을 참조하세요.

확장 프로그램 설정

VS Code는 사용자 설정에서 initialPermissionMode를 읽고 작업 영역 값을 무시합니다. v2.1.225 이전에는 VS Code가 설정을 기본값 default로 설정하고 작업 영역 값을 적용했습니다.

설정 기본값 설명
useTerminal false 그래픽 패널 대신 터미널 모드에서 Claude를 실행합니다
initialPermissionMode - 새 대화에 대한 승인 프롬프트를 제어합니다: default, plan, acceptEdits 또는 bypassPermissions. manual은 default의 별칭이며 모드 표시기에서 Manual로 표시된 모드를 선택합니다. 설정을 해제하면 확장 프로그램이 권한 모드 전환에 설명된 대로 시작 권한 모드를 선택합니다.
preferredLocation panel Claude가 열리는 위치: sidebar(오른쪽) 또는 panel(새 탭)
autosave true Claude가 파일을 읽거나 쓰기 전에 파일을 자동 저장합니다
useCtrlEnterToSend false Enter 대신 Ctrl/Cmd+Enter를 사용하여 프롬프트를 보냅니다
enableNewConversationShortcut false Cmd/Ctrl+N을 활성화하여 새 대화를 시작합니다
enableReopenClosedSessionShortcut true Cmd/Ctrl+Shift+T를 사용하여 가장 최근에 닫은 Claude 세션 탭을 다시 엽니다. 마지막으로 닫은 탭이 Claude 세션이 아닌 경우 바로 가기는 VS Code의 일반 reopen-closed-editor 명령을 대신 실행합니다.
hideOnboarding false 온보딩 체크리스트(졸업 모자 아이콘) 숨기기
focusView false 도구 호출, 도구 결과 및 생각을 확장 가능한 행 뒤에 숨기고 프롬프트와 Claude의 응답을 남깁니다. Claude의 최신 할 일 목록은 계속 표시됩니다. 이는 Claude Code v2.1.225 이상이 필요합니다. 명령 메뉴에서 포커스 보기를 전환할 수도 있습니다. Claude Code v2.1.221 이상 필요
respectGitIgnore true 파일 검색에서 .gitignore 패턴 제외
usePythonEnvironment true Claude를 실행할 때 작업 영역의 Python 환경을 활성화합니다. Python 확장 프로그램이 필요합니다.
environmentVariables [] Claude 프로세스에 대한 환경 변수를 설정합니다. 공유 구성의 경우 Claude Code 설정을 대신 사용합니다.
disableLoginPrompt false 인증 프롬프트 건너뛰기(타사 공급자 설정의 경우)
allowDangerouslySkipPermissions false 모드 선택기에 권한 무시를 추가합니다. 인터넷 접근이 없는 샌드박스에서만 사용합니다.
claudeProcessWrapper - Claude 프로세스를 실행하는 데 사용되는 실행 파일입니다. 번들된 바이너리 경로는 존재할 때 인수로 전달됩니다. 확장 프로그램 빌드가 플랫폼에 포함되지 않은 경우 별도로 설치된 claude 바이너리로 설정합니다. 래핑된 설정에서는 initialPermissionMode를 설정하거나 이전 대화에서 Manual, Edit automatically 또는 Auto를 선택하지 않는 한 대화가 Manual 모드에서 시작됩니다. 확장 프로그램이 설정 및 기본 제공 기본값 단계를 건너뛰기 때문입니다. 권한 모드 전환을 참조하세요. 활성화 시 "Unsupported platform" 오류는 플랫폼에 번들된 바이너리가 없음을 의미합니다. 어떤 플랫폼에 미리 빌드된 바이너리가 있는지 참조하세요.

화면 읽기 프로그램 사용

확장 프로그램의 채팅 패널은 화면 읽기 프로그램과 호환됩니다. 아무것도 켤 필요가 없습니다. 확장 프로그램은 시각적 변화 없이 모든 사용자에 대해 대화 활동을 알립니다. 이는 터미널 인터페이스를 조정하는 CLI의 선택적 화면 읽기 모드와는 별개입니다.

채팅 패널의 화면 읽기 프로그램 지원은 Claude Code v2.1.236 이상이 필요합니다.

대화 중에 확장 프로그램은 다음을 알립니다:

  • Claude의 응답: 확장 프로그램은 각 응답을 완료되었을 때 한 번 알리고, 텍스트가 스트리밍되는 동안 침묵을 유지합니다. 화면 읽기 프로그램은 코드 블록을 줄 수 요약으로 읽고, 링크를 레이블로 읽으며, 표를 셀 단위로 읽습니다. 전체 응답은 기록에서 읽을 수 있는 상태로 유지됩니다.
  • 권한 요청 및 질문: 확장 프로그램은 권한 프롬프트가 나타날 때 요청을 알리고, Claude가 사용하려는 도구의 이름을 지정합니다. Claude가 질문을 할 때와 Claude가 계획을 완료하고 검토를 기다릴 때도 같은 방식으로 알립니다.
  • 상태 변경: 확장 프로그램은 Claude가 작업을 시작할 때, Claude가 입력을 기다릴 준비가 되었을 때, Claude Code가 대화를 압축하기 시작할 때를 알립니다.
  • 오류 및 모델 프롬프트: 확장 프로그램은 대화의 오류를 알리고, 사용량-크레딧 동의 프롬프트 또는 플래그된 요청 프롬프트가 나타날 때를 알립니다.

기록의 각 턴은 턴을 시작한 프롬프트로 레이블이 지정된 시각적으로 숨겨진 제목으로 시작되므로, 화면 읽기 프로그램의 제목 탐색을 사용하여 턴 사이를 이동할 수 있습니다. Tab을 사용하여 기록 자체에 포커스를 이동할 수도 있습니다. 확장 프로그램이 기록을 레이블이 지정된 영역으로 노출하기 때문입니다. 그리고 자신의 속도로 읽을 수 있습니다. Claude가 작업하는 동안, 화면 읽기 프로그램은 진행률 스피너의 애니메이션 대신 텍스트 레이블을 읽습니다.

세션을 다시 열거나 다른 세션으로 전환할 때, 확장 프로그램은 아무것도 알리지 않습니다. 복원된 기록, 보류 중인 권한 프롬프트, 진행 중인 상태는 새로운 일이 발생할 때까지 침묵을 유지합니다.

VS Code 확장 프로그램 vs. Claude Code CLI

Claude Code는 VS Code 확장 프로그램(그래픽 패널)과 CLI(터미널의 명령줄 인터페이스) 모두로 사용할 수 있습니다. 일부 기능은 CLI에서만 사용할 수 있습니다. CLI 전용 기능이 필요한 경우 VS Code의 통합 터미널에서 claude를 실행하십시오. 이를 위해서는 독립 실행형 CLI 설치가 필요합니다. 확장 프로그램은 claude를 PATH에 추가하지 않습니다. VS Code에서 CLI 실행을 참조하십시오.

기능 CLI VS Code 확장 프로그램
명령 및 기술 모두 부분 집합 (채팅 패널에서 /를 입력하여 사용 가능한 항목 확인)
MCP 서버 구성 예 예 (채팅 패널에서 /mcp를 사용하여 서버 추가 및 관리)
Checkpoints 예 예
! bash 바로 가기 예 아니요
Tab 완성 예 아니요

Checkpoints를 사용한 되감기

VS Code 확장 프로그램은 Claude의 파일 편집을 추적하고 이전 상태로 되돌릴 수 있는 checkpoints를 지원합니다. 메시지 위에 마우스를 올려 되감기 버튼을 표시한 다음 세 가지 옵션 중에서 선택합니다.

  • 여기서 대화 분기: 모든 코드 변경 사항을 유지하면서 이 메시지에서 새 대화 분기를 시작합니다.
  • 여기까지 코드 되감기: 전체 대화 기록을 유지하면서 파일 변경 사항을 이 지점으로 되돌립니다.
  • 대화 분기 및 코드 되감기: 새 대화 분기를 시작하고 파일 변경 사항을 이 지점으로 되돌립니다.

Checkpoints의 작동 방식 및 제한 사항에 대한 자세한 내용은 Checkpointing을 참조하십시오.

VS Code에서 CLI 실행

VS Code에 머물면서 CLI를 사용하려면 통합 터미널을 열고 (Windows/Linux에서는 Ctrl+`, Mac에서는 Cmd+`) claude를 실행합니다. CLI는 diff 보기 및 진단 공유와 같은 기능을 위해 IDE와 자동으로 통합됩니다.

확장 프로그램을 설치해도 claude가 셸 PATH에 추가되지 않습니다. 확장 프로그램은 채팅 패널을 위해 CLI의 개인 복사본을 번들로 제공하지만, 터미널에서 claude를 입력하려면 독립 실행형 CLI 설치가 필요합니다. 설치를 한 번 실행하면 이 페이지의 명령(예: claude mcp add 및 claude --resume)이 모든 터미널에서 작동합니다. 설치 후에도 claude를 찾을 수 없으면 PATH 확인을 참조하십시오.

외부 터미널을 사용하는 경우 Claude Code 내에서 /ide를 실행하여 VS Code에 연결합니다.

확장 프로그램과 CLI 간 전환

확장 프로그램과 CLI는 동일한 대화 기록을 공유합니다. 확장 프로그램 대화를 CLI에서 계속하려면 터미널에서 claude --resume을 실행합니다. 이렇게 하면 대화를 검색하고 선택할 수 있는 대화형 선택기가 열립니다.

프롬프트에 터미널 출력 포함

@terminal:name을 사용하여 프롬프트에서 터미널 출력을 참조합니다. 여기서 name은 터미널의 제목입니다. 이를 통해 Claude는 복사하여 붙여넣기 없이 명령 출력, 오류 메시지 또는 로그를 볼 수 있습니다.

백그라운드 프로세스 모니터링

확장 프로그램의 백그라운드 작업 가시성은 CLI에 비해 제한적입니다. 더 나은 가시성을 위해 Claude가 명령을 출력하도록 하여 VS Code의 통합 터미널에서 실행할 수 있습니다.

MCP를 사용하여 외부 도구에 연결

MCP(Model Context Protocol) 서버는 Claude에게 외부 도구, 데이터베이스 및 API에 대한 액세스를 제공합니다.

VS Code를 떠나지 않고 MCP 서버를 관리하려면 채팅 패널에서 /mcp를 입력합니다. 열리는 대화 상자에서 서버를 추가하고, 로컬, 사용자 또는 프로젝트 범위에 저장된 서버를 제거하고, 서버를 활성화 또는 비활성화하고, 서버에 다시 연결하고, OAuth 인증을 관리할 수 있습니다. 대화 상자에서 서버를 추가하고 제거하려면 Claude Code v2.1.261 이상이 필요합니다.

VS Code의 통합 터미널에서 claude mcp add를 실행할 수도 있습니다 (Ctrl+` 또는 Cmd+`). 대화 상자와 터미널 명령은 동일한 MCP 구성에 저장되며, 둘 중 하나의 변경 사항은 이후에 시작하는 대화에 적용됩니다. 아래 예제는 개인 액세스 토큰으로 인증하는 GitHub의 원격 MCP 서버를 추가합니다. 이 토큰은 헤더로 전달됩니다.

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

YOUR_GITHUB_PAT을 개인 액세스 토큰으로 바꿉니다. claude mcp add 명령은 자격 증명을 검증하지 않고 구성을 저장하므로 여기에 자리 표시자 값이 허용되지만 서버가 나중에 연결하지 못합니다. 연결을 확인하려면 새 대화를 시작하고 /mcp를 입력한 다음 서버가 Connected를 표시하는지 확인합니다. 잘못된 자격 증명이 있는 서버는 Failed를 표시합니다.

구성되면 Claude에게 도구를 사용하도록 요청합니다 (예: "Review PR #456").

연결할 서버를 찾으려면 MCP 서버 찾기 및 빌드를 참조하십시오.

git으로 작업하기

Claude Code는 git과 통합되어 VS Code에서 직접 버전 제어 워크플로우를 지원합니다. Claude에게 변경 사항을 커밋하거나, 풀 리퀘스트를 생성하거나, 브랜치 간에 작업하도록 요청할 수 있습니다. 자체 파일과 브랜치가 있는 격리된 worktree에서 Claude를 시작하려면 worktree를 사용하여 병렬 세션 실행을 참조하십시오.

커밋 및 풀 리퀘스트 생성

Claude는 변경 사항을 스테이징하고, 커밋 메시지를 작성하며, 작업을 기반으로 풀 리퀘스트를 생성할 수 있습니다:

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

풀 리퀘스트를 생성할 때, Claude는 실제 코드 변경 사항을 기반으로 설명을 생성하며 테스트 또는 구현 결정에 대한 컨텍스트를 추가할 수 있습니다.

타사 제공자 사용

기본적으로 Claude Code는 Anthropic의 API에 직접 연결됩니다. 조직에서 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 사용하여 Claude에 액세스하는 경우, 대신 제공자를 사용하도록 확장 프로그램을 구성하세요:

1

로그인 프롬프트 비활성화

로그인 프롬프트 비활성화 설정을 열고 확인란을 선택하세요.

VS Code 설정(Mac에서 Cmd+, 또는 Windows/Linux에서 Ctrl+,)을 열고 "Claude Code login"을 검색한 후 로그인 프롬프트 비활성화를 선택할 수도 있습니다.

2

제공자 구성

제공자에 대한 설정 가이드를 따르세요:

이 가이드는 ~/.claude/settings.json에서 제공자를 구성하는 방법을 다루며, 이를 통해 VS Code 확장 프로그램과 CLI 간에 설정이 공유됩니다.

타사 제공자에서 확장 프로그램은 사용 추적, 음성 받아쓰기 및 클라우드 세션을 위한 웹 탭과 같이 claude.ai 계정이 필요한 기능을 제공하지 않습니다. 이전 /login에서 남겨진 claude.ai 로그인은 사용되지 않습니다: 확장 프로그램은 이를 어떤 요청과도 함께 보내지 않습니다.

보안 및 개인정보 보호

사용자의 코드는 비공개로 유지됩니다. Claude Code는 코드를 처리하여 지원을 제공하지만 모델 학습에 사용하지 않습니다. 데이터 처리 및 로깅 거부 방법에 대한 자세한 내용은 데이터 및 개인정보 보호를 참조하십시오.

자동 편집 권한이 활성화되면 Claude Code는 VS Code가 자동으로 실행할 수 있는 VS Code 구성 파일(예: settings.json 또는 tasks.json)을 수정할 수 있습니다. 신뢰할 수 없는 코드로 작업할 때 위험을 줄이려면:

  • 신뢰할 수 없는 작업 공간에 대해 VS Code 제한 모드를 활성화하십시오
  • 자동 편집 또는 자동 편집 대신 수동 모드를 사용하십시오
  • 변경 사항을 수락하기 전에 신중하게 검토하십시오

기본 제공 IDE MCP 서버

확장 프로그램이 활성화되면 CLI가 자동으로 연결하는 로컬 MCP 서버를 실행합니다. 이것이 CLI가 VS Code의 기본 diff 뷰어에서 diff를 열고, @-멘션에 대한 현재 선택 항목을 읽으며, Jupyter 노트북에서 작업할 때 VS Code에 셀 실행을 요청하는 방식입니다.

서버의 이름은 ide이며 구성할 항목이 없으므로 /mcp에서 숨겨집니다. 그러나 조직에서 PreToolUse 훅을 사용하여 MCP 도구를 허용 목록에 추가하는 경우 이 서버가 존재한다는 것을 알아야 합니다.

선택 및 열린 파일 컨텍스트. 연결되어 있는 동안 CLI는 현재 편집기 선택 항목과 활성 파일의 경로를 각 프롬프트에 컨텍스트로 포함합니다. 트랜스크립트는 이 경우 ⧉ Selected N lines from <file> 줄을 표시합니다. .env와 같은 민감한 파일을 제외하려면 해당 경로에 대한 Read 거부 규칙을 추가하십시오. 일치하는 거부 규칙은 선택된 텍스트와 해당 파일에 대한 열린 파일 공지가 Claude에 도달하는 것을 모두 방지합니다.

전송 및 인증. 서버는 10000–65535 범위의 임의 포트에서 127.0.0.1에 바인딩되며 포트는 구성할 수 없습니다. 전송은 암호화되지 않은 ws://입니다. 소켓이 루프백 전용이므로 트래픽을 캡처할 수 있는 모든 프로세스는 잠금 파일에서 토큰을 읽을 수도 있으므로 TLS는 보호를 추가하지 않습니다. 각 확장 프로그램 활성화는 새로운 임의 인증 토큰을 생성하고 ~/.claude/ide/<port>.lock의 잠금 파일에 기록하며 CLI는 이를 X-Claude-Code-Ide-Authorization 헤더로 제시하여 연결해야 합니다. 잠금 파일은 0700 디렉터리에서 0600 권한을 가지므로 VS Code를 실행하는 사용자만 읽을 수 있습니다. CLAUDE_CONFIG_DIR이 설정된 경우 잠금 파일은 대신 $CLAUDE_CONFIG_DIR/ide/에 기록됩니다.

모델에 노출된 도구. 서버는 약 12개의 도구를 호스팅하지만 모델에는 2개만 표시됩니다. 나머지는 CLI가 자체 UI(diff 열기, 선택 항목 읽기, 파일 저장)에 사용하는 내부 RPC이며 도구 목록이 Claude에 도달하기 전에 필터링됩니다.

도구 이름(훅에서 보이는 대로) 기능 읽기 전용
mcp__ide__getDiagnostics 언어 서버 진단(VS Code의 문제 패널의 오류 및 경고)을 반환합니다. 선택적으로 한 파일로 범위를 지정할 수 있습니다. 예
mcp__ide__executeCode 활성 Jupyter 노트북의 커널에서 Python 코드를 실행합니다. 아래의 확인 흐름을 참조하십시오. 아니요

Jupyter 실행은 항상 먼저 요청합니다. mcp__ide__executeCode는 아무것도 자동으로 실행할 수 없습니다. 각 호출에서 코드는 활성 노트북의 끝에 새 셀로 삽입되고 VS Code는 이를 보기로 스크롤하며 기본 빠른 선택이 실행 또는 취소를 요청합니다. 취소하거나 Esc로 선택기를 닫으면 Claude에 오류가 반환되고 아무것도 실행되지 않습니다. 이 도구는 활성 노트북이 없을 때, Jupyter 확장 프로그램(ms-toolsai.jupyter)이 설치되지 않았을 때 또는 커널이 Python이 아닐 때 완전히 거부합니다.

일반적인 문제 해결

확장 프로그램이 설치되지 않음

Spark 아이콘이 보이지 않음

Spark 아이콘은 파일이 열려 있을 때 편집기 도구 모음(편집기 우측 상단)에 나타납니다. 아이콘이 보이지 않으면:

  1. 파일 열기: 아이콘이 작동하려면 파일이 열려 있어야 합니다. 폴더만 열려 있으면 충분하지 않습니다.
  2. VS Code 버전 확인: 1.94.0 이상 필요(도움말 → 정보)
  3. VS Code 다시 시작: 명령 팔레트에서 "Developer: Reload Window" 실행
  4. 충돌하는 확장 프로그램 비활성화: 다른 AI 확장 프로그램(Cline, Continue 등) 임시 비활성화
  5. 작업 영역 신뢰 확인: 확장 프로그램은 제한된 모드에서 작동하지 않습니다

또는 preferredLocation을 sidebar로 설정했거나 Claude Code: Open in Side Bar로 Claude를 열었다면, 상태 표시줄(우측 하단 모서리)의 "✱ Claude Code"를 클릭하세요. 이는 파일이 열려 있지 않아도 작동합니다. 명령 팔레트(Cmd+Shift+P / Ctrl+Shift+P)를 사용하고 "Claude Code"를 입력할 수도 있습니다.

macOS에서 Cmd+Esc가 작동하지 않음

macOS Tahoe 이상에서는 시스템 Game Overlay 단축키가 기본적으로 Cmd+Esc에 바인딩되어 있으며 VS Code에 도달하기 전에 키 입력을 가로챕니다. 단축키를 해제하려면:

  1. 시스템 설정 열기
  2. 키보드로 이동한 후 키보드 단축키, 그 다음 게임 컨트롤러로 이동
  3. Game Overlay 체크박스 선택 해제

또는 확장 프로그램을 다른 키로 다시 바인딩하세요: VS Code 키보드 단축키 편집기(Cmd+K Cmd+S)를 열고 Claude Code: Focus input을 검색한 후 새 바인딩을 할당하세요.

Claude Code가 응답하지 않음

Claude Code가 프롬프트에 응답하지 않으면:

  1. 인터넷 연결 확인: 안정적인 인터넷 연결이 있는지 확인하세요
  2. 새 대화 시작: 새로운 대화를 시작하여 문제가 지속되는지 확인하세요
  3. CLI 시도: 터미널에서 claude를 실행하여 더 자세한 오류 메시지를 확인하세요

문제가 지속되면 오류에 대한 세부 정보와 함께 GitHub에 이슈를 제출하세요.

확장 프로그램 제거

Claude Code 확장 프로그램을 제거하려면:

  1. 확장 프로그램 보기를 엽니다 (Mac에서는 Cmd+Shift+X, Windows/Linux에서는 Ctrl+Shift+X)
  2. "Claude Code"를 검색합니다
  3. 제거를 클릭합니다

VS Code 통합 터미널에서 claude를 실행하면 Claude Code가 확장 프로그램을 자동으로 다시 설치합니다. 제거된 상태로 유지하려면 /config에서 Auto-install IDE extension을 끄거나, autoInstallIdeExtension을 false로 설정합니다. CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL 환경 변수를 1로 설정할 수도 있습니다.

확장 프로그램 데이터를 제거하고 모든 설정을 초기화하려면 플랫폼에 해당하는 확장 프로그램의 저장소 디렉터리를 삭제합니다.

macOS에서:

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

Linux에서:

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Windows에서 PowerShell에서:

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

추가 도움말은 문제 해결 가이드를 참조하십시오.

다음 단계

이제 VS Code에서 Claude Code를 설정했습니다:

  • 일반적인 워크플로우 살펴보기를 통해 Claude Code를 최대한 활용하세요
  • MCP 서버 설정을 통해 외부 도구로 Claude의 기능을 확장하세요. 채팅 패널에서 /mcp를 사용하여 추가하고 관리할 수 있습니다.
  • Claude Code 설정 구성을 통해 허용된 명령어, 훅 등을 사용자 정의하세요. 이러한 설정은 확장 프로그램과 CLI 간에 공유됩니다.