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에 액세스하는 경우 설정 지침은 타사 공급자 사용을 참조하십시오.

​

확장 프로그램 설치

• VS Code용 설치
• Cursor용 설치

• 기타 VS Code 포크: 확장 프로그램은 Devin Desktop이나 Kiro 같은 포크에도 설치됩니다. 편집기의 Extensions 보기에서 “Claude Code”를 검색하거나 Open VSX 레지스트리에서 설치합니다.
• 확장 프로그램을 설치할 수 없는 편집기: 대신 CLI를 설치하고 편집기의 통합 터미널에서 claude를 실행합니다. CLI는 모든 터미널에서 작동합니다.
• 개발 컨테이너: 개발 컨테이너 내부에서 Claude Code를 실행하려면 개발 컨테이너를 참조하세요.

​

시작하기

1

Claude Code 패널 열기

VS Code 전반에서 Spark 아이콘은 Claude Code를 나타냅니다: Claude를 가장 빠르게 여는 방법은 Editor Toolbar(에디터 오른쪽 상단 모서리)에서 Spark 아이콘을 클릭하는 것입니다. 이 아이콘은 파일이 열려 있을 때만 표시됩니다.Claude Code를 여는 다른 방법은 다음과 같습니다.

• Activity Bar: 왼쪽 사이드바에서 Spark 아이콘을 클릭하면 세션 목록이 열립니다. 세션을 클릭하면 선호하는 위치에서 열리며, 새 세션을 시작할 수도 있습니다. 이 아이콘은 Activity Bar에 항상 표시됩니다.
• Command Palette: Cmd+Shift+P(Mac) 또는 Ctrl+Shift+P(Windows/Linux)를 누르고 “Claude Code”를 입력한 다음 “Open in New Tab”과 같은 옵션을 선택합니다.
• Status Bar: 창 오른쪽 하단 모서리의 ✻ Claude Code를 클릭합니다. 파일이 열려 있지 않아도 작동합니다.

Claude 패널을 드래그하여 VS Code 내 원하는 위치로 옮길 수 있습니다. 자세한 내용은 워크플로 사용자 지정을 참조하세요.

2

로그인

패널을 처음 열면 로그인 화면이 나타납니다. Sign in을 클릭하고 브라우저에서 인증을 완료합니다.이후 Not logged in · Please run /login이 표시되면 확장 프로그램이 자동으로 로그인 화면을 다시 엽니다. 로그인 화면이 나타나지 않으면 Command Palette에서 Developer: Reload Window로 창을 다시 로드합니다.셸에 ANTHROPIC_API_KEY를 설정했는데도 로그인 프롬프트가 표시된다면 VS Code가 셸 환경을 상속하지 못했을 수 있습니다. 환경 변수를 상속하도록 터미널에서 code .로 VS Code를 실행하거나, 대신 Claude 계정으로 로그인합니다.로그인하면 Learn Claude Code 체크리스트가 나타납니다. Show me를 클릭하여 각 항목을 진행하거나 X를 눌러 닫을 수 있습니다. 나중에 다시 열려면 VS Code 설정의 Extensions > Claude Code에서 Hide Onboarding의 체크를 해제합니다.

3

프롬프트 보내기

무언가의 작동 방식 설명, 문제 디버깅, 변경 작업 등 코드나 파일과 관련된 도움을 Claude에게 요청합니다.

Claude는 선택한 텍스트를 자동으로 인식합니다. Option+K(Mac) / Alt+K(Windows/Linux)를 누르면 @-멘션 참조(예: @file.ts#5-10)도 프롬프트에 삽입됩니다.

다음은 파일의 특정 줄에 대해 질문하는 예시입니다.

4

변경 사항 검토

프롬프트 상자 하단에 표시된 권한 모드를 확인합니다.

• Auto 또는 Edit automatically 모드에서는 Claude가 확인 없이 워크스페이스의 대부분의 파일을 편집합니다.
• Manual 모드에서는 Claude가 파일을 편집하려 할 때 원본과 제안된 변경 사항을 나란히 비교하여 보여준 다음 권한을 요청합니다. 수락하거나 거부할 수 있으며, 대신 무엇을 해야 할지 Claude에게 지시할 수도 있습니다. 수락하기 전에 diff 보기에서 제안된 내용을 직접 편집하면, Claude는 사용자가 내용을 수정했다는 사실을 전달받으므로 파일이 원래 제안과 일치한다고 가정하지 않습니다.

제안된 편집을 변경 하나씩 검토하려면 diff의 각 변경 아래에 있는 Accept this change 및 Reject this change 버튼을 사용합니다. 변경을 거부하면 제안된 내용에서 해당 변경이 되돌려지고, 수락하면 검토 완료로 표시됩니다. 변경별 검토에는 Claude Code v2.1.275 이상이 필요합니다.파일 전체를 수락하거나 거부해도 검토가 완료됩니다. 변경이 100개를 초과하는 diff는 변경별 버튼 없이 열리므로 파일 전체 단위로 검토합니다.동일한 작업은 에디터의 컨텍스트 메뉴에서 커서 위치에 대해 수행할 수 있으며, Command Palette에서도 Claude Code: Accept Change at Cursor 및 Claude Code: Reject Change at Cursor로 사용할 수 있습니다.

​

프롬프트 상자 사용하기

• 권한 모드: 프롬프트 상자 하단의 모드 표시기를 클릭하여 권한 모드를 전환합니다. Claude Code v2.1.283 이상에서는 Auto가 기본 제공 시작 권한 모드이며, 이전 버전에서는 Pro, Max, Team 플랜에서만 그렇습니다. 이를 바꾸는 요인과 표시기가 제공하는 모든 권한 모드는 확장 프로그램이 시작 권한 모드를 선택하는 방식을 참조하세요.
  • Auto: 사용자에게 묻는 대신 분류기가 대부분의 작업을 검토합니다. 검토 및 차단 대상은 자동 모드를 참조하세요.
  • Manual: Claude가 파일 편집 및 대부분의 셸 명령 전에 권한을 요청합니다.
  • Plan: Claude가 수행할 작업을 설명하고 변경하기 전에 승인을 기다립니다. VS Code는 플랜을 전체 Markdown 문서로 자동으로 열며, Claude가 작업을 시작하기 전에 인라인 댓글을 추가하여 피드백을 제공할 수 있습니다. 프롬프트 상자에 /plan을 입력할 수도 있습니다. Claude Code v2.1.280 이상이 필요합니다.
    • /plan: 플랜 모드로 전환합니다. 이미 플랜 모드인 경우 현재 플랜을 대신 보여줍니다.
    • /plan fix the auth bug처럼 작업과 함께 입력한 /plan: 플랜 모드로 전환하고 해당 작업의 계획을 시작합니다.
    • /plan open: 이미 플랜 모드인 경우 편집기에서 플랜 파일을 엽니다.
  • Edit automatically: Claude가 묻지 않고 편집합니다.
• 모델: 명령 메뉴에서 **Switch model…**을 선택하여 세션 중에 모델을 변경합니다. 프롬프트 상자 하단의 모델 이름을 클릭하여 같은 선택기를 열 수도 있습니다. Claude Code v2.1.284 이상에서는 프롬프트 상자에 /model만 입력해도 선택기가 열립니다. 현재 모델이 effort 수준을 지원하는 경우 선택기에 Effort 행도 표시되며, 모델 이름 버튼에 선택된 수준이 표시됩니다. max 이외의 수준을 선택하면 Claude Code는 이를 현재 모델의 기본값으로 사용자 설정의 modelSettings 아래에 저장합니다. max는 현재 세션에만 적용됩니다. 모델 이름 버튼과 Effort 행에는 Claude Code v2.1.257 이상이 필요합니다. 동적 워크플로가 활성화되어 있고 현재 모델이 이를 지원하면 Effort 행 아래에 Ultracode 스위치가 나타납니다. 이를 켜면 Claude가 이 세션의 각 실질적인 작업에 대해 선택된 effort 수준으로 워크플로를 계획합니다. 켜져 있는 동안 모델 이름 버튼에는 수준 뒤에 · Ultracode가 표시됩니다. 이 스위치에는 Claude Code v2.1.284 이상이 필요합니다.
• 명령 메뉴: /를 클릭하거나 입력하여 명령 메뉴를 엽니다. 파일 첨부, 모델 전환, 확장 사고 켜기/끄기 등의 옵션이 있습니다. Customize 섹션에는 MCP 서버, 명령, 출력 스타일, 훅, 메모리, 지침, 권한, 플러그인 같은 항목이 포함됩니다. 터미널 아이콘이 있는 항목은 통합 터미널에서 열립니다.
  • /usage나 /remote-control 같은 명령을 찾아보려면 Customize 섹션에서 Slash commands를 선택합니다. 필터 상자와 함께 명령 목록이 대화 상자에 표시됩니다. 하나를 선택하면 실행됩니다. 프롬프트 상자에 /를 입력하면 여전히 인라인으로 명령이 제안됩니다. Claude Code v2.1.257 이상이 필요합니다. /skills를 입력해도 이 대화 상자가 열립니다. 각 스킬 행에는 On 또는 Name only 같은 표시 여부가 나타납니다. 표시 여부를 클릭하여 변경할 수 있지만, 플러그인 스킬처럼 locked로 표시된 행은 제외됩니다. /skills 단축 명령과 표시 여부 컨트롤에는 Claude Code v2.1.280 이상이 필요합니다.
  • 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 이상이 필요합니다.
  • Customize 섹션에서 Memory를 선택하여 자동 메모리를 켜거나 끕니다. 켜져 있는 동안 Claude가 저장한 메모리를 찾아보고, 메모리가 저장된 폴더를 파일 관리자에서 열 수도 있습니다. Claude Code v2.1.274 이상이 필요합니다. 저장된 메모리를 클릭하면 대화 상자에서 읽을 수 있으며, 그곳에서 텍스트를 편집하거나 메모리를 삭제하거나 편집기에서 파일을 열 수 있습니다. 대화 상자에서 메모리를 보고, 편집하고, 삭제하려면 Claude Code v2.1.275 이상이 필요합니다.
  • Customize 섹션에서 Instructions를 선택하여 Claude가 읽는 CLAUDE.md 파일을 편집합니다. 파일을 선택하면 편집기에서 열립니다. 파일이 아직 없으면 Claude Code가 먼저 생성합니다. Claude Code v2.1.274 이상이 필요합니다.
  • Customize 섹션에서 Status를 선택하거나 /status를 입력하여 세션의 Claude Code 버전, 계정, 모델, MCP 서버 세부 정보를 확인합니다. Claude Code v2.1.280 이상이 필요합니다.
  • Customize 섹션에서 Sandbox를 선택하거나 /sandbox를 입력하여 Claude의 Bash 명령이 샌드박스에서 실행되는지 확인합니다. 그곳에서 샌드박스 모드를 전환하고 제외 명령을 추가할 수 있습니다. Claude Code v2.1.280 이상이 필요합니다.
  • Customize 섹션에서 Claude in Chrome을 선택하거나 /chrome을 입력하여 Claude in Chrome 연결을 확인하고 관리합니다. 두 방법 모두 claude.ai 계정으로 로그인해야 합니다. Claude Code v2.1.280 이상이 필요합니다.
  • Context 섹션에서 Export conversation을 선택하거나 /export를 입력하여 대화를 일반 텍스트로 복사하거나 파일로 저장합니다. /export notes.txt처럼 파일 이름을 추가하면 대화 상자를 건너뛰고 파일을 저장할 위치를 선택할 수 있습니다. Claude Code v2.1.280 이상이 필요합니다.
  • 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)를 누르거나, 명령 팔레트에서 Claude Code: Toggle Focus view를 사용합니다. 변경 사항은 열려 있는 모든 세션에 적용되며 세션 간에 유지됩니다. Claude Code v2.1.221 이상이 필요합니다. Claude의 최신 할 일 목록은 계속 표시되며, Claude의 대기 중인 질문이 묻고 있는 텍스트도 마찬가지입니다. 이 기능에는 Claude Code v2.1.225 이상이 필요합니다. Claude가 서브에이전트를 실행하는 동안, 최신 활동이 담긴 실시간 진행 상황 행이 해당 서브에이전트를 시작한 도구 호출 그룹 아래에 나타납니다. 이 기능에는 Claude Code v2.1.269 이상이 필요합니다.
  • Anthropic 계정에서 로그아웃하려면 Settings 섹션에서 Sign out을 선택하거나 /logout을 입력합니다. 서드파티 제공업체에서는 메뉴가 둘 다 제공하지 않습니다. Claude Code v2.1.277 이상이 필요합니다.
  • 버그를 신고하려면 메뉴 하단의 Report a problem을 클릭하거나, 보고서를 미리 채우는 선택적 설명과 함께 /bug 또는 /feedback을 입력합니다. 보고서를 제출할 때 퍼스트 파티 연결에서 Anthropic에 로그인되어 있으면 Claude Code가 이를 Anthropic에 전송합니다. Claude Code v2.1.229 이상이 필요합니다. 서드파티 제공업체에서 또는 Anthropic 자격 증명 없이 사용하는 경우에는 아무것도 전송되지 않습니다. 작성하기 전에 대화 상자에 그렇게 안내됩니다. 제출하면 알려진 API 키와 토큰 패턴이 삭제된 상태로 보고서가 ~/.claude/feedback-bundles/ 아래의 로컬 아카이브로 저장됩니다. 보고서를 컴퓨터에 저장하려면 Claude Code v2.1.284 이상이 필요합니다. 보고서가 저장되면 확인 메시지에 파일 이름이 표시되고 Show folder 버튼이 포함됩니다. 해당 파일을 Anthropic 계정 담당자에게 보내거나 지원 요청에 첨부합니다. 조직의 정책이 제품 피드백을 끈 경우 Report a problem이 메뉴에 나타나지 않으며, /bug와 /feedback은 보고서를 여는 대신 Feedback is turned off by your organization's policy or this environment's settings. 알림을 표시합니다. Claude Code v2.1.284 이상에서는 DISABLE_FEEDBACK_COMMAND 또는 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 환경 변수를 설정한 경우에도 피드백이 꺼지며, 보고서를 열면 대신 해당 알림이 표시됩니다.
• 곁가지 질문: /btw 뒤에 질문을 입력하여 대화에 추가하지 않고 세션에 대해 질문합니다. 답변은 채팅 옆 패널에 열리며, 그곳에서 후속 질문을 할 수 있습니다. Claude Code v2.1.227 이상이 필요합니다. 스레드는 창을 다시 로드해도 유지됩니다. Claude Code는 최신 20개의 주고받은 내용을 보관하며, Claude Code가 보존 기간을 안전하게 결정할 수 있는 한 cleanupPeriodDays 일정에 따라 저장된 스레드를 만료시킵니다. 스레드를 지우려면 패널의 휴지통 아이콘을 클릭합니다.
• 응답 복사: 응답 위에 마우스를 올리고 Copy response를 클릭하여 클립보드에 복사하거나, /copy를 입력하여 최신 응답을 복사합니다. /copy 2는 끝에서 두 번째 응답을 복사합니다. Claude Code v2.1.277 이상이 필요합니다.
• 북마크: 응답 위에 마우스를 올리고 Bookmark response를 클릭하여 저장하거나, 저장된 응답에서 Remove bookmark를 클릭하여 제거합니다. 저장된 응답을 검토하려면 Bookmarks 패널을 엽니다. Claude Code 패널 상단의 북마크 아이콘을 클릭하거나, 명령 메뉴의 Context 섹션에서 Bookmarks를 선택하거나, /bookmarks를 입력하면 됩니다. Claude Code v2.1.286 이상이 필요합니다.
• Claude가 보내는 파일: 세션이 Remote Control에 연결되어 있고 Claude가 SendUserFile 도구로 파일을 보내면, 대화에 Sent report.md, chart.png 같은 행이 표시됩니다. 파일 이름을 클릭하면 편집기에서 열립니다.
• 컨텍스트 표시기: 프롬프트 상자에 Claude의 컨텍스트 윈도우를 얼마나 사용하고 있는지 표시됩니다. Claude는 필요할 때 자동으로 압축하며, /compact를 수동으로 실행할 수도 있습니다.
• 프롬프트 캐시 시계: 컨텍스트 표시기 옆의 시계 아이콘은 대화의 프롬프트 캐시가 만료되기까지 남은 시간을 추정합니다. 캐시의 5분 또는 1시간 수명부터 카운트다운하며, 캐시를 사용하는 각 응답마다 카운트다운이 다시 시작됩니다. 압축을 제외하면 캐시를 무효화하는 작업은 시계를 재설정하지 않으므로, 모델을 전환한 후에도 남은 시간(분)이 계속 표시될 수 있습니다.
  • 카운트다운이 끝나기 전까지 아이콘에는 12m처럼 남은 시간(분)이 표시됩니다.
  • 카운트다운이 끝나면 다음 응답까지 분 표시가 사라지고 아이콘이 빨간색 또는 테마의 오류 색상으로 바뀝니다. 캐시가 만료되었을 가능성이 높으므로, 캐시가 다시 구축되는 동안 다음 메시지에 대한 응답은 더 느리고 비용이 더 많이 들 수 있습니다. 메시지 사이에 5분 수명이 계속 만료된다면 TTL 직접 선택하기를 참조하세요.
  • 대화가 압축된 직후에도 캐시가 아직 압축된 대화를 포함하지 않기 때문에, 다음 응답까지 아이콘이 분 표시 없이 빨간색으로 바뀝니다.
• 에이전트 맵: 대화에 서브에이전트가 포함되면 프롬프트 상자 하단에 2 agents 같은 에이전트 수가 나타납니다. 점은 서브에이전트가 작업 중인지 또는 사용자의 권한을 기다리고 있는지를 보여줍니다. 에이전트 수를 클릭하면 에이전트 맵이 열리며, 대화의 서브에이전트가 메인 에이전트 아래 트리로 표시되고 각각 상태, 경과 시간, 토큰 수가 나타납니다. 서브에이전트를 클릭하면 해당 프롬프트와 도구 호출을 보거나, 읽기 전용 트랜스크립트를 열거나, 실행 중에 중지할 수 있습니다. Claude Code v2.1.269 이상이 필요합니다. 맵에는 에이전트 아래에 백그라운드 셸 명령 및 모니터 같은 세션의 다른 백그라운드 작업도 나열됩니다. 행을 클릭하면 작업 카드가 열리며 그곳에서 작업을 중지할 수 있습니다. Claude가 서브에이전트 없이 백그라운드 셸만 시작한 경우처럼 에이전트 수가 표시되지 않을 때 맵을 열려면 프롬프트 상자에 /tasks를 입력합니다. 맵의 백그라운드 작업과 /tasks 입력에는 Claude Code v2.1.277 이상이 필요합니다. Claude Code v2.1.286 이상에서는 Stop을 클릭하거나 Esc를 누르면 현재 턴이 종료됩니다. 백그라운드 에이전트는 완료되거나 맵에서 중지할 때까지 계속 실행됩니다.
• 확장 사고: Claude가 복잡한 문제를 추론하는 데 더 많은 시간을 쓸 수 있게 합니다. 명령 메뉴(/)에서 켭니다. Claude의 추론은 대화에 접힌 블록으로 나타납니다. 블록을 클릭하여 읽거나, Ctrl+O를 눌러 세션의 모든 사고 블록을 펼치거나 접을 수 있습니다. 자세한 내용은 확장 사고를 참조하세요.
• 여러 줄 입력: 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)

• 파일이 워크스페이스 안에 있고 files.exclude 또는 search.exclude 설정과 일치하면, Claude는 선택한 텍스트가 아닌 최대 파일 경로만 받습니다.
• VS Code의 search.useIgnoreFiles 설정과 확장 프로그램의 respectGitIgnore 설정이 모두 켜져 있으면(기본값) git이 무시하는 파일에도 동일하게 적용됩니다.

• 이미지를 첨부하려면 클립보드에서 프롬프트 상자에 붙여넣습니다.
• 파일을 첨부하려면 Shift를 누른 상태로 프롬프트 상자에 드래그합니다.
• 컨텍스트에서 첨부 파일을 제거하려면 첨부 파일의 X를 클릭합니다.

​

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

​

텍스트 붙여넣기

• 붙여넣을 때 Removed 3 invisible characters from the pasted text 같은 알림이 나타나면, 해당 문자가 제거된 상태로 텍스트가 입력된 것입니다.
• 전송할 때 제거된 문자에 대한 알림이 나타나면 아무것도 전송되지 않은 것입니다. 정리된 텍스트가 프롬프트 상자에 다시 들어가 있습니다. 표시된 텍스트를 보내려면 다시 전송합니다.

​

응답의 LaTeX 수식

• 디스플레이 수식: 한 줄 또는 여러 줄에 단독으로 있는 $$ … $$ 또는 \[ … \] 블록, 그리고 언어가 math인 펜스 코드 블록
• 인라인 수식: $E = mc^2$ 또는 \(a^2 + b^2 = c^2\)처럼 같은 줄에서 열리고 닫히는 $…$ 또는 \(…\)

​

이전 대화 재개하기

• 세션 제목: 새 세션은 첫 메시지를 기반으로 AI가 생성한 제목을 받습니다.
• 이름 변경 및 보관: 세션 위에 마우스를 올리면 이러한 작업이 나타납니다. 이름을 변경하여 설명적인 제목을 부여하거나, 보관하여 목록 하단의 Archived sessions 그룹으로 이동합니다.

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• 세션 하나: Archived sessions를 펼치고 Unarchive session을 클릭합니다.
• 보관된 모든 세션 한꺼번에: 활동 표시줄의 세션 목록에서 Archived sessions 헤더 위에 마우스를 올리고 보관 해제 아이콘을 클릭합니다. Claude Code v2.1.277 이상이 필요합니다.

• 확장 프로그램이 claudeCode.initialPermissionMode 또는 이전 대화에서 이어진 선택으로부터 시작 권한 모드를 선택하는 경우
• claudeCode.claudeProcessWrapper가 구성되어 있는 경우
• 거부 규칙이 ExitPlanMode 도구를 제거하는 경우

​

claude.ai의 클라우드 세션 재개하기

​

계정 및 사용량 확인하기

• claude.ai 플랜: 현재 세션 및 주간 같은 플랜 한도에 대한 사용량 막대가 표시됩니다. 각 막대는 한도가 재설정되기까지 남은 시간을 보여줍니다. 대화 상자는 플랜 한도에 영향을 주는 요인도 분석합니다. 캐시 미스, 긴 컨텍스트, 서브에이전트를 많이 사용하거나 병렬성이 높은 세션처럼 최근 사용량의 10% 이상을 차지하는 동작을 표시합니다. 표시된 각 동작에는 이를 줄이기 위한 팁이 함께 제공됩니다. 기여도 표는 각 스킬, 서브에이전트, 플러그인, MCP 서버에서 발생한 사용량을 보여줍니다. Day 및 Week 토글을 사용하여 지난 24시간과 지난 7일 간에 전환합니다. 수치는 근사치이며 이 머신의 로컬 세션에서 계산되므로, 다른 기기나 claude.ai의 사용량은 포함되지 않습니다.
• 기타 로그인: 서드파티 제공업체를 사용하거나 API 키를 사용하는 경우처럼 플랜 한도가 로그인에 적용되지 않으면, Usage 섹션에 대신 세션 자체의 비용과 토큰 사용량이 표시됩니다. CLI의 /usage는 Session 블록에 동일한 합계를 표시합니다. 활동 표시줄의 세션 목록도 Account & usage 헤더 아래에 활성 세션의 합계를 표시합니다. Claude Code v2.1.277 이상이 필요합니다.

​

체크포인트로 되감기

• Fork conversation from here: 모든 코드 변경 사항을 그대로 유지하면서 이 메시지에서 새 대화 분기를 시작합니다
• Rewind code to here: 전체 대화 기록을 유지하면서 파일 변경 사항을 대화의 이 시점으로 되돌립니다
• Fork conversation and rewind code: 새 대화 분기를 시작하고 파일 변경 사항을 이 시점으로 되돌립니다

​

워크플로 사용자 지정

​

Claude 위치 선택

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

​

다시 로드 후 대화 이어가기

• 편집기 탭: 대화가 해당 탭과 함께 다시 열립니다.
• 사이드바: 최근 10분 이내에 메시지를 보냈거나 Claude가 응답한 경우 대화가 다시 열립니다. 다시 열리지 않으면 세션 기록에서 대화를 재개합니다.

​

다시 로드 후 중단된 단계

​

다시 로드 후 이어서 진행 끄기

​

대화가 다시 열리지 않은 경우

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• 그래도 열려면: Open it anyway를 클릭하거나 세션 기록에서 대화를 선택합니다. 대화가 열리고 패널이 계속 정상적으로 작동하면, 이후 다시 로드할 때 평소처럼 대화가 다시 열립니다. 패널이 다시 응답을 멈추면 창을 다시 로드하여 알림이 있는 새 채팅으로 돌아갑니다.
• 닫힌 상태로 두려면: 새 채팅에서 계속 작업합니다. 프롬프트를 보내면 알림이 사라집니다.

​

여러 대화 실행

​

세션을 그룹으로 정리

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

​

세션 목록 필터링

• Active: 이 토글을 켜면 입력이 필요하거나, 작업 중이거나, 읽지 않은 세션과 함께 마지막으로 포커스한 Claude 탭의 세션만 표시됩니다.
• 상태별 필터링: 깔때기 아이콘을 클릭한 다음 Needs input, Working 또는 Completed를 선택하여 해당 상태 중 하나에 있는 세션을 표시합니다. Open 또는 Closed를 선택하면 세션이 열려 있는지 여부로 목록을 좁힐 수 있습니다. 세션이 이 창에 탭을 가지고 있거나, 터미널과 같이 이 컴퓨터의 다른 Claude Code 프로세스에서 실행 중이면 열린 것으로 간주됩니다.

​

터미널 모드로 전환

​

플러그인 관리

​

플러그인 설치

• 설치된 플러그인이 상단에 표시되며, 토글 스위치로 활성화하거나 비활성화할 수 있습니다.
  • 프로젝트의 공유 .claude/settings.json에서 켜 둔 플러그인을 끄려고 하면 확장 프로그램이 먼저 확인을 요청합니다. Disable for me는 본인에게만 플러그인을 끄고, Disable for everyone은 공유 파일을 변경합니다.
  • 로드에 실패한 플러그인은 해당 행에 간단한 이유를 표시합니다. 이유를 클릭하면 취할 수 있는 조치를 확인할 수 있으며, 여기에는 플러그인 문제 해결에서 찾아볼 수 있도록 전체 오류 메시지를 복사하는 기능도 포함됩니다.
• 구성된 마켓플레이스의 사용 가능한 플러그인이 아래에 표시됩니다
• 검색을 통해 이름이나 설명으로 플러그인을 필터링할 수 있습니다
• 사용 가능한 플러그인에서 Install을 클릭합니다

• Install for you: 모든 프로젝트에서 사용 가능(사용자 범위)
• Install for this project: 프로젝트 협업자와 공유(프로젝트 범위)
• Install locally: 본인만, 이 저장소에서만 사용 가능(로컬 범위)

​

플러그인 제거

• 프로젝트의 공유 .claude/settings.json에서 켜 둔 플러그인: 협업자에게는 플러그인이 설치된 상태로 유지되는 Disable for me를 선택하거나, --keep-data와 함께 프로젝트의 설치를 제거하여 플러그인의 저장된 데이터 디렉터리는 남겨 두는 Uninstall for everyone을 선택합니다. 이미 본인에 대해 플러그인을 꺼 둔 경우에는 휴지통 아이콘을 클릭하면 확인 없이 본인의 설치가 제거됩니다.
• 그 외의 경우, 저장된 데이터가 있는 플러그인의 마지막 설치: 데이터를 유지할지 삭제할지 선택합니다. 기본값은 Keep입니다

​

플러그인 설치 링크 공유

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

• 플러그인 이름: 최대 100자이며, ASCII 문자 또는 숫자로 시작하고 나머지는 ASCII 문자, 숫자, ., _, -만 사용해야 합니다.
• 마켓플레이스 소스: marketplace 매개변수에 나열된 형식만 허용되므로, 로컬 경로, http:// 주소 또는 claude-plugins-official과 같은 마켓플레이스 이름은 사용할 수 없습니다. https:// URL에는 사용자 이름, 비밀번호 또는 쿼리 문자열을 포함할 수 없습니다.
• Git ref: 마켓플레이스를 브랜치나 태그에 고정하려면 marketplace=owner/repo%23v1.0처럼 #의 인코딩 형식인 %23 뒤에 ref를 소스에 덧붙입니다. 인코딩되지 않은 #이 포함된 링크는 실패합니다. anthropics GitHub 조직의 마켓플레이스는 링크에서 고정할 수 없습니다.

• 마켓플레이스에 해당 이름의 플러그인이 없는 경우: 대화 상자에 플러그인을 찾을 수 없다고 표시됩니다. plugin 값을 마켓플레이스의 목록과 대조하여 확인합니다.
• 플러그인이 이미 설치된 경우: 대화 상자에 그 사실이 표시되며, 아무것도 변경되지 않습니다.
• 같은 이름의 다른 마켓플레이스가 이미 추가된 경우: 대화 상자에 링크의 마켓플레이스가 추가되지 않았다고 표시되며, 아무것도 설치되지 않습니다.

​

마켓플레이스 관리

• GitHub 저장소, URL 또는 로컬 경로를 입력하여 새 마켓플레이스를 추가합니다
• 새로고침 아이콘을 클릭하여 마켓플레이스의 플러그인 목록을 업데이트합니다
• 휴지통 아이콘을 클릭하여 마켓플레이스를 제거합니다. 마켓플레이스를 제거하면 해당 마켓플레이스에서 설치한 모든 플러그인이 제거되므로, 먼저 해당 플러그인 이름을 표시하는 확인 창이 나타납니다

​

패널에 그리는 플러그인

• 대화 옆 또는 프롬프트 상자 위의 창
• 프롬프트 상자 위의 토스트 또는 상태줄
• 플러그인 고유의 방식으로 그려진 메시지나 도구 호출

• From the token-chart plugin: 플러그인이 이것을 그리거나 출력했거나, 이 카드가 플러그인이 사용자에게 무언가를 묻는 것입니다
• Edited by the token-chart plugin: 플러그인이 도구 호출처럼 Claude Code가 그리는 항목을 변경했습니다
• Prompt from the token-chart plugin: 플러그인이 사용자를 대신하여 이 메시지를 보냈습니다

​

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

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

• 기본적으로 Chrome 활성화하기: @browser를 입력하지 않아도 각 세션이 시작될 때 브라우저에 연결되도록 설정합니다
• VS Code 세션의 권한 프롬프트: Claude Code가 브라우저 작업 전에 확인을 요청하는 경우를 설명합니다
• Chrome과 함께 Claude Code 사용하기: 설정 방법, 전체 기능 목록, 문제 해결을 다룹니다

​

git으로 작업하기

​

커밋 및 풀 리퀘스트 생성

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

​

백그라운드에서 작업 실행하기

​

실행 중인 명령 또는 서브에이전트를 백그라운드로 이동하기

• 표시 시점: 이 동작은 명령이 약 2초 동안 실행된 후, 또는 서브에이전트가 시작되는 즉시 나타납니다.
• 클릭한 후: Claude는 기다리는 것을 멈추고 턴을 계속 진행합니다. 명령 또는 서브에이전트는 완료 시 Claude에게 알리는 백그라운드 작업으로 계속 실행됩니다.

​

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

​

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 간에 공유됩니다. 허용된 명령, 환경 변수, 훅, MCP 서버에 사용합니다. Claude Code v2.1.283 이상에서는 대화가 시작되는 권한 모드를 결정하는 입력 중 하나이기도 하며, 이전 버전에서는 Pro, Max, Team 플랜에서만 해당됩니다. 권한 모드 전환에 그 순서가 나와 있습니다. 자세한 내용은 설정을 참조하세요.

​

확장 프로그램 설정

​

서드파티 공급자 사용

​

스크린 리더 사용

• Claude의 응답: 확장 프로그램은 각 응답이 완료되었을 때 한 번 안내하며, 텍스트가 스트리밍되는 동안에는 안내하지 않습니다. 스크린 리더는 코드 블록을 줄 수 요약으로 읽고, 링크는 레이블로 읽으며, 표는 셀 단위로 읽습니다. 전체 응답은 트랜스크립트에서 계속 읽을 수 있습니다.
• 권한 요청 및 질문: 확장 프로그램은 권한 프롬프트가 나타날 때 Claude가 사용하려는 도구의 이름과 함께 요청을 안내합니다. Claude가 사용자에게 질문할 때와 Claude가 계획을 마치고 사용자의 검토를 기다릴 때도 같은 방식으로 안내합니다.
• 상태 변경: 확장 프로그램은 Claude가 작업을 시작할 때, Claude가 사용자의 입력을 받을 준비가 되었을 때, Claude Code가 대화 압축을 시작할 때 안내합니다.
• 대기 중인 메시지: Claude가 작업하는 동안 메시지를 보내면 확장 프로그램은 해당 메시지에 대해 “Message queued.”라고 안내합니다.
• 오류 및 모델 프롬프트: 확장 프로그램은 대화 중 발생한 오류를 안내하며, 사용량 크레딧 동의 프롬프트 또는 플래그된 요청 프롬프트가 나타날 때도 안내합니다.

​

키보드로 채팅 패널 사용

• 사용자의 메시지: “You”
• Claude의 메시지: “Claude”
• 도구 단계: “Claude”와 도구 이름(예: “Claude, Bash”)
• 사고 블록: “Claude, thinking”

• 해당 옵션에 포커스를 둔 상태에서 Left 또는 Right 화살표 키를 누릅니다. 각 저장 위치로 이동할 때마다 확장 프로그램이 해당 위치를 안내합니다. 화살표 키를 사용하려면 Claude Code v2.1.268 이상이 필요합니다.
• 레이블에서 저장 위치를 클릭합니다.

​

VS Code 확장 프로그램과 Claude Code CLI 비교

​

VS Code에서 CLI 실행

​

확장 프로그램과 CLI 간 전환

​

MCP로 외부 도구에 연결하기

• 서버 추가
• 로컬, 사용자 또는 프로젝트 범위에 저장된 서버 제거
• 서버 활성화 또는 비활성화
• 서버에 다시 연결
• OAuth 인증 관리

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

​

내장 IDE MCP 서버

• VS Code의 기본 diff 뷰어에서 diff를 엽니다
• @ 멘션을 위해 현재 선택 영역을 읽습니다
• Jupyter 노트북에서 작업할 때 VS Code에 셀 실행을 요청합니다

• 대기열에 추가된 메시지: Claude가 작업하는 동안 메시지를 대기열에 추가하면, 이후에 무엇을 선택하든 Enter를 눌렀을 때의 선택 영역이 유지됩니다.
• 민감한 파일: .env와 같은 민감한 파일을 제외하려면 해당 경로에 대한 Read 거부 규칙을 추가합니다. 일치하는 거부 규칙이 있으면 해당 파일의 선택된 텍스트와 열린 파일 알림이 모두 Claude에 전달되지 않습니다.
• Attach Open File 꺼짐: Attach Open File 설정을 끄면 CLI는 활성 파일에서 텍스트를 선택한 동안에만 해당 파일의 경로를 받습니다.

• 전송 방식: 암호화되지 않은 ws://입니다. 소켓은 루프백 전용이므로 트래픽을 가로챌 수 있는 프로세스라면 잠금 파일에서 토큰도 읽을 수 있어, TLS를 사용해도 보호 수준이 높아지지 않습니다.
• 인증 토큰: 확장 프로그램이 활성화될 때마다 새로운 임의 인증 토큰이 생성되어 ~/.claude/ide/<port>.lock의 잠금 파일에 기록됩니다. CLI가 연결하려면 이 토큰을 X-Claude-Code-Ide-Authorization 헤더로 제시해야 합니다.
• 잠금 파일 권한: 잠금 파일은 0700 디렉터리 안에 0600 권한으로 저장되므로 VS Code를 실행하는 사용자만 읽을 수 있습니다. CLAUDE_CONFIG_DIR이 설정되어 있으면 잠금 파일은 대신 $CLAUDE_CONFIG_DIR/ide/에 기록됩니다.

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. 코드가 활성 노트북 끝에 새 셀로 삽입됩니다.
2. VS Code가 해당 셀이 보이도록 스크롤합니다.
3. 기본 Quick Pick이 Execute 또는 Cancel을 선택하도록 묻습니다.

​

일반적인 문제 해결

​

확장 프로그램이 설치되지 않는 경우

• 호환되는 VS Code 버전(1.94.0 이상)인지 확인합니다
• VS Code에 확장 프로그램을 설치할 권한이 있는지 확인합니다
• VS Code Marketplace에서 직접 설치해 봅니다

​

Spark 아이콘이 보이지 않는 경우

1. 파일 열기: 아이콘을 표시하려면 파일이 열려 있어야 합니다. 폴더만 열려 있는 것으로는 충분하지 않습니다.
2. VS Code 버전 확인: 1.94.0 이상이 필요합니다. Help > About에서 확인합니다
3. VS Code 재시작: Command Palette에서 “Developer: Reload Window”를 실행합니다
4. 충돌하는 확장 프로그램 비활성화: 다른 AI 확장 프로그램(Cline, Continue 등)을 일시적으로 비활성화합니다
5. 워크스페이스 신뢰 확인: 확장 프로그램은 Restricted Mode에서 작동하지 않습니다

​

macOS에서 Cmd+Esc가 작동하지 않는 경우

1. System Settings를 엽니다
2. Keyboard, Keyboard Shortcuts, Game Controllers 순으로 이동합니다
3. Game Overlay 체크박스를 해제합니다

​

재개한 대화가 처음에 비어 있는 경우

​

다시 로드로 대화가 다시 열릴 때마다 패널이 응답하지 않는 경우

​

수식이 원시 LaTeX로 표시되는 경우

• 수식이 아닌 다른 것으로 읽히는 경우: $O(n log n)$처럼 단어로 읽히는 $…$ 텍스트는 작성된 그대로 유지됩니다. $30$이나 $1/N$처럼 숫자로 시작하는 $…$ 텍스트도 =, +, ^ 같은 문자가 수식임을 표시하지 않는 한 작성된 그대로 유지됩니다. 대신 별도의 줄에 $$ 블록으로 작성해 달라고 Claude에게 요청하십시오. 패널은 이 검사 없이 해당 블록을 조판합니다.
• 공백이 있거나, 길거나, 여러 줄로 나뉜 경우: 달러 기호 안쪽에 공백이 있는 $ x^2 $, 60자를 넘는 $…$ 내용, 두 줄로 나뉜 $…$ 또는 \(…\)는 조판되지 않습니다. 대신 별도의 줄에 $$ 블록으로 작성해 달라고 Claude에게 요청하십시오. 해당 블록에는 이러한 제한이 없습니다.
• TeX를 조판할 수 없는 경우: 구문 오류가 있는 수식, \newcommand나 \def 같은 매크로 정의, 이스케이프되지 않은 %는 작성된 그대로 표시됩니다. 오류를 수정하거나, 매크로 없이 작성하거나, 퍼센트 기호에 \%를 사용하여 다시 작성해 달라고 Claude에게 요청하십시오.
• 너무 큰 경우: 8,192자보다 긴 수식이나 소스보다 훨씬 크게 그려지는 수식은 작성된 그대로 표시됩니다. 더 작은 수식으로 나누거나 더 간결하게 작성해 달라고 Claude에게 요청하십시오.
• 많은 양의 수식 뒤에 오는 경우: 응답의 한 텍스트 블록 안에서 패널은 한도까지 수식을 순서대로 조판합니다. 한도를 넘어서는 이후 수식은 작성된 그대로 표시됩니다. 필요한 수식만 따로 다시 보내 달라고 Claude에게 요청하십시오.

​

Claude Code가 응답하지 않는 경우

1. 인터넷 연결 확인: 인터넷 연결이 안정적인지 확인합니다
2. 새 대화 시작: 새 대화를 시작하여 문제가 계속되는지 확인합니다
3. CLI 사용해 보기: 터미널에서 claude를 실행하여 더 자세한 오류 메시지가 표시되는지 확인합니다

​

확장 프로그램 제거

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

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를 사용하여 MCP 서버를 추가하고 관리합니다.
• Claude Code 설정 구성으로 허용된 명령, 훅 등을 사용자 지정할 수 있습니다. 이 설정은 확장 프로그램과 CLI 간에 공유됩니다.
• Claude Code의 보안 안전 장치 및 데이터 사용을 검토합니다