Claude Code VS Code 연동 방법 2026 — 설정부터 실전 활용까지

VS Code와 Claude Code, 함께 쓰면 더 강력하다

Claude Code는 터미널 기반 도구입니다. 터미널만으로도 충분히 강력하지만, 많은 개발자들이 VS Code와 함께 사용하면서 생산성을 한 단계 더 끌어올리고 있습니다.

VS Code에서 코드를 직접 보면서 Claude Code로 명령을 내리는 방식은 두 도구의 장점을 동시에 활용할 수 있는 가장 효율적인 워크플로우입니다. 코드를 눈으로 확인하면서 AI에게 수정을 지시하고, 결과를 바로 에디터에서 확인할 수 있습니다.

이 글에서는 Claude Code와 VS Code를 연동하는 방법을 2026년 기준으로 설정부터 실전 활용까지 단계별로 정리합니다.

연동 방식 두 가지

Claude Code와 VS Code를 함께 사용하는 방식은 크게 두 가지입니다.

첫 번째, VS Code 내장 터미널 활용

VS Code 안에 내장된 터미널에서 Claude Code를 실행하는 방식입니다. 별도의 설정 없이 바로 사용할 수 있어 가장 간단합니다. VS Code 에디터와 Claude Code 터미널을 한 화면에서 나란히 볼 수 있어 작업 흐름이 자연스럽습니다.

두 번째, Claude Code 공식 VS Code 확장 프로그램 활용

Anthropic에서 공식으로 제공하는 VS Code 확장 프로그램을 설치하는 방식입니다. 내장 터미널 방식보다 더 깊은 수준으로 통합되며, 에디터 안에서 Claude Code의 결과를 더 직관적으로 확인할 수 있습니다.

두 방식 모두 유효하며, 처음 시작하는 분이라면 내장 터미널 방식으로 먼저 사용해보고 익숙해지면 확장 프로그램을 추가하는 것을 권장합니다.

방법 1 — VS Code 내장 터미널에서 Claude Code 실행하기

터미널 열기

VS Code에서 내장 터미널을 여는 단축키는 다음과 같습니다.

macOS: Control + 백틱(`)
Windows: Control + 백틱(`)

상단 메뉴에서 Terminal > New Terminal을 선택해도 됩니다.

프로젝트 폴더 열기

VS Code에서 작업할 프로젝트 폴더를 먼저 열어야 합니다. File > Open Folder를 선택해 프로젝트 폴더를 열면 내장 터미널도 자동으로 해당 폴더 경로에서 시작됩니다.

Claude Code 실행

내장 터미널에서 아래 명령어를 입력합니다.

claude

Claude Code가 실행되면 VS Code 에디터 창을 보면서 터미널에 명령을 입력할 수 있습니다. 에디터에서 특정 파일을 열어두고 “지금 열려 있는 파일의 버그를 찾아줘”처럼 맥락에 맞는 명령을 내릴 수 있습니다.

방법 2 — VS Code 확장 프로그램 설치하기

확장 프로그램 설치

VS Code 왼쪽 사이드바에서 확장 프로그램 아이콘을 클릭합니다. 검색창에 Claude Code를 입력하면 Anthropic에서 제공하는 공식 확장 프로그램이 나타납니다. 설치 버튼을 클릭해 설치합니다.

설치가 완료되면 VS Code를 재시작합니다.

확장 프로그램 활성화

재시작 후 VS Code 오른쪽 상단에 Claude Code 아이콘이 표시됩니다. 아이콘을 클릭하면 Claude Code 패널이 열립니다. 처음 실행 시 로그인 화면이 나타나며, Claude.ai 계정으로 로그인하면 연동이 완료됩니다.

이미 터미널에서 로그인을 완료한 상태라면 별도의 로그인 없이 바로 사용할 수 있는 경우도 있습니다.

실전 활용 — 이렇게 쓰면 효율이 올라간다

특정 파일을 열어두고 명령 내리기

VS Code에서 수정하고 싶은 파일을 에디터에 열어둔 상태에서 Claude Code에 명령을 내리면 더 정확한 결과를 얻을 수 있습니다.

현재 열려 있는 파일에서 중복된 코드를 찾아서 함수로 분리해줘
이 파일의 함수들에 JSDoc 주석을 추가해줘
이 파일에서 사용하지 않는 변수를 찾아서 정리해줘

에디터와 터미널 분할 화면으로 사용하기

VS Code에서 에디터와 터미널을 분할 화면으로 배치하면 코드를 보면서 Claude Code 명령 결과를 실시간으로 확인할 수 있습니다.

View > Editor Layout > Split Down을 선택하면 화면을 위아래로 나눌 수 있습니다. 위쪽에는 코드 에디터를, 아래쪽에는 Claude Code 터미널을 배치하면 작업 흐름이 훨씬 자연스럽습니다.

Git 작업을 VS Code와 함께 처리하기

VS Code의 소스 컨트롤 탭에서 변경된 파일을 확인하면서 Claude Code로 커밋 작업을 처리하는 방식도 효율적입니다.

변경된 내용을 기반으로 커밋 메시지를 작성하고 커밋해줘
현재 변경사항을 요약해줘

VS Code 소스 컨트롤 탭에서 변경 내용을 눈으로 확인하고, Claude Code로 커밋까지 처리하면 실수를 줄이면서 빠르게 작업할 수 있습니다.

오류 메시지를 그대로 붙여넣어 해결하기

VS Code 터미널에서 오류가 발생했을 때 오류 메시지를 그대로 복사해서 Claude Code에 붙여넣으면 원인과 해결 방법을 바로 안내해줍니다.

아래 오류가 발생했는데 원인과 해결 방법을 알려줘
[오류 메시지 붙여넣기]

멀티 터미널 활용하기

VS Code는 여러 개의 터미널을 동시에 열 수 있습니다. 이 기능을 활용하면 Claude Code와 일반 터미널을 동시에 운영할 수 있습니다.

터미널 탭 오른쪽의 + 버튼을 클릭하면 새 터미널이 추가됩니다. 하나의 터미널에서는 Claude Code를 실행하고, 다른 터미널에서는 서버 실행이나 패키지 설치 같은 일반 작업을 처리하는 방식으로 사용하면 효율적입니다.

Windows WSL 환경에서 VS Code 연동하기

Windows 사용자라면 WSL 환경에서 VS Code를 연동하는 추가 설정이 필요합니다.

VS Code 확장 프로그램에서 WSL을 검색해 Microsoft 공식 WSL 확장 프로그램을 설치합니다. 설치 후 VS Code 왼쪽 하단의 연결 버튼을 클릭하고 WSL에 연결을 선택합니다.

WSL에 연결된 VS Code가 실행되면 내장 터미널이 자동으로 WSL Ubuntu 환경으로 열립니다. 이 상태에서 claude 명령어를 입력하면 Claude Code가 정상적으로 실행됩니다.

자주 겪는 문제

VS Code 내장 터미널에서 claude 명령어를 찾을 수 없다고 나온다

VS Code 내장 터미널은 시스템 터미널과 동일한 환경을 사용하지만, 간혹 PATH 설정이 제대로 불러와지지 않는 경우가 있습니다. VS Code를 완전히 종료하고 다시 실행해보세요. 그래도 해결되지 않는다면 VS Code 설정에서 terminal.integrated.env 항목을 확인해야 합니다.

확장 프로그램 설치 후 Claude Code 아이콘이 보이지 않는다

VS Code를 완전히 재시작해보세요. 재시작 후에도 보이지 않는다면 확장 프로그램이 정상적으로 설치되었는지 확인하고, 필요하면 재설치합니다.

WSL 연동 후 파일 경로가 이상하게 표시된다

WSL 환경에서는 Windows 파일 경로(/mnt/c/…)와 Linux 파일 경로가 다르게 표시됩니다. VS Code WSL 확장 프로그램을 통해 연결한 경우 파일 경로가 자동으로 변환되지만, 직접 경로를 입력할 때는 Linux 형식으로 입력해야 합니다.

마무리

VS Code와 Claude Code를 연동하면 에디터의 시각적 편의성과 Claude Code의 강력한 에이전트 기능을 동시에 활용할 수 있습니다. 처음에는 내장 터미널 방식으로 시작해서 작업 흐름에 익숙해진 뒤, 공식 확장 프로그램을 추가하는 순서로 진행하는 것을 권장합니다.

분할 화면 배치와 멀티 터미널 활용만으로도 작업 효율이 눈에 띄게 달라집니다. 오늘 바로 설정해보시길 권장합니다. 다음 글에서는 Claude Code를 사용하면서 자주 겪는 오류와 해결 방법을 2026년 기준으로 총정리해드리겠습니다.

다음 글 예고: Claude Code 설치 오류 해결 모음 2026 — 자주 겪는 문제 10가지

9번 글로 바로 이어서 작성할까요? “네”라고 답해주시면 진행하겠습니다.