IDE 연동

이 챕터에서 배우는 것: VS Code Extension 설치, JetBrains 플러그인, IDE 없이 터미널만 사용하는 방법

참고

IDE 연동은 선택 사항입니다. Claude Code는 터미널만으로도 완전히 사용 가능합니다. IDE 연동을 하면 클릭 한 번으로 실행하거나, 코드와 AI 창을 나란히 볼 수 있어 편리합니다.

---

VS Code 연동

VS Code 1.98.0 이상이 필요합니다. Cursor IDE에서도 동일한 확장 프로그램을 설치할 수 있습니다.

공식 확장 프로그램 설치

1. VS Code 열기 (또는 Cursor)
2. 확장 프로그램 마켓플레이스 (Ctrl+Shift+X / Cmd+Shift+X)
3. "Claude Code" 검색
4. Anthropic 공식 확장 프로그램 → Install

VS Code에서 Claude Code 실행

설치 후 여러 방법으로 실행할 수 있습니다:

• 에디터 툴바: 파일이 열려 있을 때 오른쪽 상단의 Spark(✱) 아이콘 클릭
• 활동 표시줄(왼쪽): Claude 아이콘 클릭 → 세션 목록에서 선택 또는 새 세션 시작
• Command Palette: Cmd+Shift+P / Ctrl+Shift+P → "Claude Code" 검색
• 상태 표시줄: 우하단 ✱ Claude Code 클릭 (파일이 열려 있지 않아도 동작)
• 통합 터미널: claude 입력으로 CLI 모드 실행

VS Code 확장 주요 기능

확장 프로그램은 CLI의 GUI 래퍼로, 다음 기능을 추가로 제공합니다:

• 인라인 diff 리뷰: Claude가 파일을 수정하면 원본과 변경사항을 나란히 비교하고 수락/거절
• @파일 참조: @파일명으로 파일을 컨텍스트에 추가. @파일명#5-10처럼 특정 줄 범위 지정 가능
• Plan 리뷰: Plan Mode에서 Claude의 계획을 마크다운 문서로 열어 인라인 코멘트로 피드백
• 멀티탭 세션: Open in New Tab / Open in New Window로 여러 대화를 병렬로 진행
• 과거 세션 탐색: 패널 상단 드롭다운에서 키워드 검색이나 시간별 탐색으로 이전 대화 재개
• 터미널 출력 참조: @terminal:이름으로 터미널의 명령 결과를 프롬프트에 포함
• 플러그인 관리: /plugins로 GUI에서 플러그인 설치/관리
• MCP 서버 관리: /mcp로 기존 서버 활성화/비활성화, OAuth 인증 관리

선택 영역 자동 인식

에디터에서 코드를 선택하면 Claude가 자동으로 인식합니다. Option+K(macOS) / Alt+K(Windows/Linux)를 누르면 파일 경로와 줄 번호가 포함된 @참조가 프롬프트에 삽입됩니다.

VS Code 단축키

단축키	설명
Cmd+Esc / Ctrl+Esc	에디터 ↔ Claude 포커스 전환
Cmd+Shift+Esc / Ctrl+Shift+Esc	새 탭에서 대화 열기
Cmd+N / Ctrl+N	새 대화 시작 (Claude 포커스 시)
Option+K / Alt+K	현재 파일+선택 영역 @참조 삽입 (에디터 포커스 시)

Windows 사용자 주의

Ctrl+Esc는 시작 메뉴, Ctrl+Shift+Esc는 작업 관리자 단축키와 충돌하여 Windows에서는 작동하지 않습니다. 대안으로 Command Palette(Ctrl+Shift+P) → "Claude Code: Focus Input" 또는 "Claude Code: Open in New Tab"을 사용하세요.

---

JetBrains IDE 연동

IntelliJ IDEA, PyCharm, WebStorm, GoLand 등 JetBrains 제품군에서 사용 가능합니다.

플러그인 설치

1. Settings (Ctrl+Alt+S / Cmd+,) → Plugins
2. Marketplace 탭 → "Claude Code" 검색
3. Anthropic 공식 플러그인 → Install
4. IDE 재시작

JetBrains에서 Claude Code 실행

• 우하단 상태 표시줄 → Claude Code 아이콘 클릭
• 또는 Tools → Claude Code 메뉴

---

터미널만 사용하기 (IDE 없이)

IDE 없이 터미널만으로도 Claude Code의 모든 기능을 사용할 수 있습니다. 특히 서버 환경이나 SSH 접속 시 유용합니다.

# 프로젝트 폴더로 이동
cd ~/my-project

# Claude Code 시작
claude

Claude Code는 현재 디렉토리를 작업 공간으로 인식합니다.

---

어떤 방식이 좋을까?

상황	권장 방식
일반 개발 작업	VS Code 확장 프로그램
Cursor 사용자	Cursor에서 Claude Code 확장 프로그램 설치
JetBrains 헤비 유저	JetBrains 플러그인
서버/원격 작업	터미널 단독
처음 시작	터미널 단독 (단순함)

---

핵심 정리

• IDE 연동은 선택 사항, 터미널만으로도 모든 기능 사용 가능
• VS Code / Cursor: 공식 Claude Code 확장 프로그램 설치
• JetBrains: JetBrains Marketplace에서 플러그인 설치
• VS Code 확장은 인라인 diff, @파일 참조, Plan 리뷰, 멀티탭 등 GUI 전용 기능 제공
• 항상 프로젝트 폴더 안에서 claude 실행 권장