Claude Code는 본래 터미널에서 실행하는 명령줄 도구지만, VS Code 확장과 JetBrains 플러그인을 설치하면 평소 쓰던 코드 편집기 안에서 그대로 사용할 수 있습니다. 코드를 보면서 대화하고, Claude가 제안한 변경을 diff로 검토하고, 선택한 코드 범위를 바로 참조시킬 수 있습니다. 이 글은 두 환경의 설치·로그인·핵심 기능을 공식 문서 기준으로 정리합니다.
IDE 연동이란?
Claude Code는 크게 세 가지 방식으로 쓸 수 있습니다. ① 터미널에서 claude 명령으로 실행하는 CLI, ② VS Code 확장, ③ JetBrains 플러그인입니다. 세 방식 모두 같은 Claude 계정과 같은 핵심 기능을 공유하며, 본질적인 차이는 '어디서 대화하느냐'입니다. IDE 연동을 쓰면 편집기를 떠나지 않고도 열려 있는 파일과 선택 영역을 Claude가 자동으로 인식하며, 변경 사항을 편집기의 diff 화면에서 바로 검토할 수 있습니다.
시작 전 준비물
- 유료 Claude 구독(Pro·Max·Team·Enterprise) 또는 Claude Console 계정이 필요합니다. API 키는 필요 없으며, 확장·플러그인을 처음 열 때 이 계정으로 로그인합니다.
- VS Code를 쓴다면 버전 1.98.0 이상이어야 합니다.
- Amazon Bedrock·Google Vertex AI 같은 서드파티 제공자를 통해 Claude에 접근한다면 별도 설정이 필요합니다.
VS Code에 설치하기
VS Code 확장은 채팅 패널용 CLI를 자체적으로 포함하고 있어, 확장만 설치하면 곧바로 대화를 시작할 수 있습니다.
- 확장 설치 — VS Code 마켓플레이스에서 'Claude Code' 확장을 찾아 설치합니다.
- 로그인 — 확장 패널을 처음 열면 로그인 화면이 나타납니다. 'Sign in'을 클릭하고 브라우저에서 인증을 완료합니다.
- 프롬프트 보내기 — 코드 설명, 디버깅, 수정 등을 요청합니다. Claude는 현재 열려 있는 파일과 선택한 코드 영역을 자동으로 인식합니다.
로그인 화면이 보이지 않으면 Command Palette(Mac은 Cmd+Shift+P, Windows·Linux는 Ctrl+Shift+P)에서 'Developer: Reload Window'로 창을 새로고침하세요. 셸에 ANTHROPIC_API_KEY가 설정돼 있는데도 로그인 화면이 계속 뜬다면, VS Code가 셸 환경 변수를 물려받지 못한 경우입니다. 터미널에서 code . 명령으로 VS Code를 실행하거나 Claude 계정으로 로그인하면 해결됩니다.
VS Code에서 할 수 있는 일
확장을 설치하면 편집기 안에서 다음 기능을 쓸 수 있습니다.
- 계획 검토·편집 — Claude가 제안한 작업 계획을 수락하기 전에 검토하고 수정할 수 있습니다.
- 편집 자동 수락 — 변경 사항을 만들어지는 대로 자동 적용하도록 설정할 수 있습니다.
- 파일 @멘션 — 선택한 코드의 특정 줄 범위를
@로 참조시킬 수 있습니다. - 대화 기록·멀티 탭 — 여러 대화를 별도 탭이나 창에서 동시에 진행할 수 있습니다.
- 체크포인트로 되돌리기 — 이전 상태로 손쉽게 복원(Rewind)할 수 있습니다.
- 플러그인·마켓플레이스 관리 — 확장에서 설정한 마켓플레이스는 CLI에서도 공유됩니다.
- Chrome 연동(@browser) —
@browser로 로컬에서 실행 중인 웹앱을 테스트하고 콘솔 로그로 디버깅할 수 있습니다(Claude in Chrome 확장 1.0.36 이상 필요). - MCP 외부 도구 연결 — MCP로 외부 도구·데이터에 연결합니다.
- git 작업 — 커밋·풀 리퀘스트 생성, git worktree를 이용한 병렬 작업을 지원합니다.
JetBrains에 설치하기
JetBrains는 전용 플러그인으로 연동합니다. IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand 등 대부분의 JetBrains 제품을 지원합니다.
- IDE의 Settings → Plugins에서 JetBrains Marketplace의 'Claude Code' 플러그인을 설치합니다.
- 설치 후 Cmd+Esc(또는 IDE의 실행 버튼)로 빠르게 실행합니다.
JetBrains 플러그인은 인터랙티브 diff 보기, 선택한 코드 영역(컨텍스트) 공유 등을 제공합니다. 원격 개발 환경에서는 플러그인을 원격 호스트(remote host)에 설치해야 합니다(로컬 클라이언트가 아닙니다). WSL2에서 'No available IDEs detected' 메시지가 나오면 WSL2의 NAT 네트워킹이나 Windows 방화벽이 IDE와의 연결을 막는 경우이며, 방화벽에서 WSL2 트래픽을 허용하면 해결됩니다.
VS Code와 JetBrains, 한눈에 비교
| 항목 | VS Code 확장 | JetBrains 플러그인 |
|---|---|---|
| 설치 위치 | VS Code 마켓플레이스 | Settings → Plugins |
| 빠른 실행 | 패널 · Command Palette | Cmd+Esc |
| 변경 검토 | 계획 검토 + diff | 인터랙티브 diff |
| CLI 포함 | 채팅용 CLI 내장 | 해당 없음 |
| 요건 | VS Code 1.98.0+ | IntelliJ·PyCharm 등 |
확장·플러그인 vs CLI — 언제 무엇을 쓸까
VS Code 확장은 채팅 패널용 CLI를 번들로 포함하므로 확장만으로 대화가 가능합니다. 다만 VS Code의 통합 터미널에서 claude 명령을 직접 실행하려면 standalone CLI를 별도로 설치해야 합니다. 정리하면, 편집기 안에서 시각적으로 작업하고 싶다면 확장·플러그인을, 스크립트·자동화·터미널 워크플로가 중심이라면 CLI를 쓰면 됩니다. 둘은 같은 계정·설정·마켓플레이스를 공유하므로 상황에 따라 함께 써도 무방합니다.
자주 묻는 질문
API 키가 꼭 필요한가요?
아니요. 유료 Claude 구독 또는 Claude Console 계정으로 로그인하면 되고, 별도의 API 키는 필요하지 않습니다.
Cursor나 Windsurf에서도 되나요?
이들은 VS Code를 기반으로 만든 편집기입니다. 다만 공식 문서가 명시적으로 설명하는 대상은 VS Code와 JetBrains이며, 그 외 편집기에서의 구체적인 동작은 공식 자료로 확인되지 않았습니다. 확실하지 않은 부분은 각 편집기의 안내를 확인하시기 바랍니다.