본문으로 건너뛰기

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현재 파일+선택 영역 @참조 삽입

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 실행 권장

다음 단계​

→ Chrome 연동 — Chrome 브라우저와 연동하여 웹앱 테스트, 디버깅을 터미널에서 바로 수행하는 방법을 배워봅시다

최종 수정: 에