VS Code에서 Claude Code 사용하기

​

필수 조건

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

​

확장 프로그램 설치

• VS Code용 설치
• Cursor용 설치

​

시작하기

1

Claude Code 패널 열기

VS Code 전체에서 Spark 아이콘은 Claude Code를 나타냅니다. Claude를 여는 가장 빠른 방법은 편집기 도구 모음(편집기의 오른쪽 상단 모서리)에서 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에게 코드나 파일을 도와달라고 요청합니다. 작동 방식 설명, 문제 디버깅 또는 변경 사항 만들기 등이 있습니다.

Claude는 자동으로 선택한 텍스트를 봅니다. Option+K(Mac) / Alt+K(Windows/Linux)를 눌러 프롬프트에 @-멘션 참조(예: @file.ts#5-10)를 삽입할 수도 있습니다.

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

4

변경 사항 검토

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

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

​

프롬프트 상자 사용

• 권한 모드: 프롬프트 상자 하단의 모드 표시기를 클릭하여 권한 모드를 전환합니다. 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 이상이 필요합니다.
  • Customize 섹션에서 Hooks를 선택하여 세션에 로드된 훅을 이벤트별로 그룹화하여 봅니다. 사용자, 프로젝트 및 로컬 설정 파일에 저장된 훅을 추가, 편집 또는 제거할 수 있습니다. 관리되는 설정 또는 플러그인과 같은 다른 소스의 훅은 읽기 전용입니다. Claude Code v2.1.269 이상이 필요합니다.
  • Customize 섹션에서 Permissions를 선택하여 세션의 권한 규칙을 Allow, Ask, Deny로 그룹화하여 봅니다. 사용자, 프로젝트 또는 로컬 설정에 규칙을 추가하고 거기에 저장된 규칙을 제거할 수 있습니다. 관리되는 설정 또는 이 세션에만 적용되는 승인과 같은 다른 소스의 규칙은 읽기 전용입니다. Claude Code v2.1.269 이상이 필요합니다.
  • 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의 응답을 남깁니다. 여기서 토글하거나, Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux)를 사용하거나, Command Palette에서 Claude Code: Toggle Focus view를 사용하여 토글합니다. 변경 사항은 모든 열려 있는 세션에 적용되고 세션 전체에서 유지됩니다. Claude Code v2.1.221 이상이 필요합니다. Claude의 최신 할 일 목록은 계속 표시되며, Claude가 묻는 보류 중인 질문의 텍스트도 표시됩니다. 이는 Claude Code v2.1.225 이상이 필요합니다. Claude가 서브에이전트를 실행하는 동안 최신 활동이 있는 라이브 진행 행이 이들을 시작한 도구 호출 그룹 아래에 나타납니다. Claude Code v2.1.269 이상이 필요합니다.
  • 버그를 보고하려면 메뉴 하단의 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를 수동으로 실행할 수 있습니다.
• Agent map: 대화에 서브에이전트가 포함되면 프롬프트 상자 하단에 2 agents와 같은 에이전트 수가 나타납니다. 점은 서브에이전트가 작동 중인지 또는 권한을 기다리고 있는지 여부를 보여줍니다. 에이전트 맵을 열려면 에이전트 수를 클릭합니다. 에이전트 맵은 대화의 서브에이전트를 주 에이전트 아래의 트리로 그리며, 각각 상태, 경과 시간 및 토큰 수를 표시합니다. 서브에이전트를 클릭하여 프롬프트 및 도구 호출을 보거나, 읽기 전용 기록을 열거나, 실행 중일 때 중지합니다. Claude Code v2.1.269 이상이 필요합니다.
• Extended thinking: Claude가 복잡한 문제를 추론하는 데 더 많은 시간을 소비할 수 있게 합니다. 명령 메뉴(/)를 통해 토글합니다. Claude의 추론은 대화에 축소된 블록으로 나타납니다. 블록을 클릭하여 읽거나 Ctrl+O를 눌러 세션의 모든 사고 블록을 확장하거나 축소합니다. 자세한 내용은 Extended thinking을 참조하세요.
• Multi-line input: Shift+Enter를 눌러 보내지 않고 새 줄을 추가합니다. 이는 질문 대화의 “Other” 자유 텍스트 입력에서도 작동합니다.

​

참조 파일 및 폴더

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

​

과거 대화 재개

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

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

​

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

​

계정 및 사용량 확인

​

워크플로우 사용자 정의

​

Claude가 위치할 곳 선택

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

• 편집기 탭: 대화가 탭과 함께 돌아옵니다.
• 사이드바: 지난 10분 이내에 메시지를 보냈거나 Claude가 응답한 경우 대화가 돌아옵니다. 돌아오지 않으면 세션 기록에서 대화를 재개합니다.

​

여러 대화 실행

​

세션을 그룹으로 정렬

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

​

터미널 모드로 전환

​

플러그인 관리

​

플러그인 설치

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

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

​

플러그인 설치 링크 공유

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

• 마켓플레이스에 해당 이름의 플러그인이 없음: 대화 상자에서 플러그인을 찾을 수 없다고 보고합니다. 마켓플레이스 목록에 대해 plugin 값을 확인합니다.
• 플러그인이 이미 설치됨: 대화 상자에서 이를 표시하며 아무것도 변경되지 않습니다.

​

마켓플레이스 관리

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

​

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

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

​

VS Code 명령어 및 단축키

​

다른 도구에서 VS Code 탭 시작

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

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

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

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

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

​

설정 구성

• 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 플랜에서는 권한 모드 대화가 시작되는 입력 중 하나이기도 합니다. 권한 모드 전환에서 순서를 나열합니다. 자세한 내용은 설정을 참조하세요.

​

확장 프로그램 설정

​

화면 읽기 프로그램 사용

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

​

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

​

Checkpoints를 사용한 되감기

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

​

VS Code에서 CLI 실행

​

확장 프로그램과 CLI 간 전환

​

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

​

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

​

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

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

​

git으로 작업하기

​

커밋 및 풀 리퀘스트 생성

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

​

타사 제공자 사용

​

보안 및 개인정보 보호

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

​

기본 제공 IDE MCP 서버

​

일반적인 문제 해결

​

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

• VS Code의 호환 버전(1.94.0 이상)이 있는지 확인하세요
• VS Code에 확장 프로그램을 설치할 권한이 있는지 확인하세요
• VS Code Marketplace에서 직접 설치를 시도하세요

​

Spark 아이콘이 보이지 않음

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

​

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

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

​

Claude Code가 응답하지 않음

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

​

확장 프로그램 제거

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

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

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

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

​

다음 단계

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