VS Code에 Claude Code 연결하기

터미널 설치와 확장은 어떻게 다른가요?

이 글은 VS Code 안의 Claude Code 확장을 사용합니다. VS Code 설치·한국어 설정과 계정·비용 구분을 먼저 마치세요.

공식 한국어 문서는 VS Code용 확장이 자체 실행에 필요한 구성을 포함한다고 안내합니다. 터미널용 Claude Code를 먼저 설치해야만 하는 경로로 설명하지 않습니다. 현재 필요한 VS Code 버전과 계정 조건은 공식 문서의 ‘필수 조건’에서 확인하세요.

정상 결과: 확장 패널에 메시지를 입력할 수 있습니다. 로그인 성공과 실제 이용 권한·사용량은 별도로 확인합니다. 구독 로그인과 API 키 방식은 구분하세요.

터미널이나 코드 파일이 아니라 Claude Code 대화 입력칸에 다음 요청을 보냅니다.

나는 VS Code를 처음 사용해.
현재 폴더와 열린 파일을 확인하고 어떤 상태인지 설명해줘.
파일을 수정하거나 명령을 실행하지 말아줘.

폴더가 맞는지 확인한 뒤 첫 HTML 실습을 진행하세요. 파일 수정 제안은 비교 화면에서 읽고, 요청한 실습 폴더에만 적용되는지 확인합니다.

열린 파일이나 선택한 코드가 대화의 맥락에 포함될 수 있으므로, 다른 프로젝트의 파일을 열어둔 채 실습 요청을 보내지 마세요. 공유하지 않을 정보는 먼저 닫거나 제외합니다.

확장 설치가 안 돼요: VS Code 버전과 조직의 확장 설치 정책을 확인합니다.
패널이 비어 있어요: 확장이 활성화되어 있는지 확인하고 공식 문서의 해당 오류 항목을 읽습니다. 같은 확장을 여러 번 설치하지 않습니다.
로그인이 반복돼요: 로그인 계정과 인증 완료 후 복귀 상태를 확인합니다. 필요한 정보만 가리고 질문 작성법에 따라 문의하세요.
터미널의 claude가 없어요: 그래픽 확장이 설치된 것과 터미널 명령이 연결된 것은 다를 수 있습니다. 현재 목표가 확장 사용인지 CLI 사용인지 먼저 구분합니다.

작업을 마친 뒤 파일 저장 여부를 확인하고 VS Code를 닫습니다. 다음 날 같은 폴더와 Claude Code 패널을 다시 열어 현재 파일 상태부터 확인하세요.

공식 문서 기반 안내이며 설치 화면과 사용 조건은 바뀔 수 있습니다. 실제 모든 운영체제에서 설치를 재현한 것은 아닙니다.