JetBrains IDE 통합

읽는 시간: 8분 | 난이도: 초급자

Claude Code는 전용 플러그인을 통해 JetBrains IDE와 통합되어 대화형 diff 보기, 선택 컨텍스트 공유 등의 기능을 제공합니다.

지원되는 IDE

Claude Code 플러그인은 다음을 포함한 대부분의 JetBrains IDE에서 작동합니다:

IntelliJ IDEA - Java, Kotlin 개발
PyCharm - Python 개발
Android Studio - Android 앱 개발
WebStorm - JavaScript, TypeScript 개발
PhpStorm - PHP 개발
GoLand - Go 개발

주요 기능

기능	설명
빠른 실행	`Cmd+Esc` (Mac) / `Ctrl+Esc` (Windows/Linux)로 편집기에서 Claude Code를 직접 열거나 UI의 Claude Code 버튼 클릭
Diff 보기	코드 변경 사항을 터미널 대신 IDE diff 뷰어에서 직접 표시
선택 컨텍스트	IDE의 현재 선택/탭이 Claude Code와 자동으로 공유됨
파일 참조 단축키	`Cmd+Option+K` (Mac) / `Alt+Ctrl+K` (Linux/Windows)로 파일 참조 삽입 (예: @File#L1-99)
진단 공유	IDE의 진단 오류(린트, 문법 등)가 작업 중 자동으로 Claude와 공유됨

설치하기

마켓플레이스에서 설치

JetBrains 마켓플레이스에서 Claude Code 플러그인을 찾아 설치한 후 IDE를 재시작합니다.

단계별 설치 방법:

JetBrains IDE를 엽니다.
Settings(설정)을 엽니다:
- Mac: Cmd+,
- Windows/Linux: Ctrl+Alt+S
Plugins (플러그인)로 이동합니다.
Marketplace 탭을 선택합니다.
검색창에 "Claude Code"를 입력합니다.
Claude Code Beta 플러그인을 찾아 Install을 클릭합니다.
설치 완료 후 IDE를 완전히 재시작합니다.

Claude Code가 아직 설치되지 않은 경우 빠른 시작 가이드에서 설치 방법을 확인하세요.

플러그인 설치 후 적용되려면 IDE를 완전히 재시작해야 할 수 있습니다.

사용 방법

IDE에서 사용하기

IDE의 통합 터미널에서 claude를 실행하면 모든 통합 기능이 활성화됩니다.

claude

통합 기능이 활성화되면:

코드 변경 사항이 IDE diff 뷰어에 표시됩니다.
현재 편집기 선택 항목이 자동으로 공유됩니다.
파일 참조를 빠르게 삽입할 수 있습니다.
린트 및 문법 오류가 자동으로 공유됩니다.

외부 터미널에서 사용하기

외부 터미널에서 /ide 명령어를 사용하여 Claude Code를 JetBrains IDE에 연결하고 모든 기능을 활성화합니다:

claude
> /ide

IDE와 동일한 파일에 접근할 수 있도록 IDE 프로젝트 루트와 동일한 디렉터리에서 Claude Code를 시작하세요.

설정하기

Claude Code 설정

IDE 통합은 Claude Code 설정을 통해 구성합니다:

claude 실행
/config 명령어 입력
자동 IDE 감지를 위해 diff 도구를 auto로 설정

플러그인 설정

**Settings → Tools → Claude Code [Beta]**로 이동하여 Claude Code 플러그인을 설정합니다.

일반 설정

설정	설명
Claude command	Claude를 실행하는 사용자 정의 명령어 지정 (예: `claude`, `/usr/local/bin/claude`, `npx @anthropic/claude`)
Suppress notification for Claude command not found	Claude 명령어를 찾지 못할 때 알림 건너뛰기
Enable using Option+Enter for multi-line prompts (macOS 전용)	활성화 시 Claude Code 프롬프트에서 Option+Enter가 새 줄 삽입
Enable automatic updates	플러그인 업데이트 자동 확인 및 설치 (재시작 시 적용)

WSL 사용자 팁: Claude 명령어로 wsl -d Ubuntu -- bash -lic "claude"를 설정합니다 (Ubuntu를 WSL 배포판 이름으로 교체).

ESC 키 설정

JetBrains 터미널에서 ESC 키가 Claude Code 작업을 중단하지 않는 경우:

Settings → Tools → Terminal로 이동
다음 중 하나를 수행합니다:
- "Move focus to the editor with Escape" 체크 해제, 또는
- "Configure terminal keybindings"를 클릭하고 "Switch focus to Editor" 단축키 삭제
변경 사항 적용

이렇게 하면 ESC 키가 Claude Code 작업을 제대로 중단할 수 있습니다.

특수 설정

원격 개발 (Remote Development)

JetBrains Remote Development를 사용할 때는 **Settings → Plugin (Host)**를 통해 원격 호스트에 플러그인을 설치해야 합니다. 로컬 클라이언트 머신이 아닌 원격 호스트에 플러그인이 설치되어야 합니다.

원격 개발 설정 단계:

원격 호스트에 연결합니다.
Settings → Plugins (Host) 탭으로 이동합니다.
마켓플레이스에서 Claude Code를 검색하여 설치합니다.
원격 호스트를 재시작합니다.

WSL 설정

WSL 사용자는 IDE 감지가 제대로 작동하도록 추가 설정이 필요할 수 있습니다. 자세한 설정 지침은 WSL 문제 해결 가이드를 참조하세요.

WSL 설정에 필요한 사항:

적절한 터미널 설정
네트워킹 모드 조정
방화벽 설정 업데이트

문제 해결

플러그인이 작동하지 않는 경우

프로젝트 루트 디렉터리에서 Claude Code를 실행하고 있는지 확인
IDE 설정에서 JetBrains 플러그인이 활성화되어 있는지 확인
IDE를 완전히 재시작 (여러 번 재시작이 필요할 수 있음)
Remote Development의 경우 플러그인이 원격 호스트에 설치되어 있는지 확인

IDE가 감지되지 않는 경우

플러그인이 설치되고 활성화되어 있는지 확인
IDE를 완전히 재시작
통합 터미널에서 Claude Code를 실행하고 있는지 확인
WSL 사용자는 WSL 문제 해결 가이드 참조

명령어를 찾을 수 없는 경우

Claude 아이콘을 클릭할 때 "command not found"가 표시되는 경우:

Claude Code가 설치되어 있는지 확인: npm list -g @anthropic-ai/claude-code
플러그인 설정에서 Claude 명령어 경로 설정
WSL 사용자는 설정 섹션에서 언급된 WSL 명령어 형식 사용

보안 고려 사항

Claude Code가 자동 편집 권한이 활성화된 JetBrains IDE에서 실행될 때 IDE가 자동으로 실행할 수 있는 IDE 설정 파일을 수정할 수 있습니다. 이는 자동 편집 모드에서 Claude Code 실행의 위험을 증가시킬 수 있습니다.

JetBrains IDE에서 실행할 때 다음을 고려하세요:

편집에 수동 승인 모드 사용: 자동 수락 대신 변경 사항을 검토하고 승인
신뢰할 수 있는 프롬프트만 사용: 특히 자동화 워크플로우에서 주의
접근 가능한 파일 인식: Claude Code가 수정할 수 있는 파일 범위 파악

차이점: VS Code vs JetBrains

기능	VS Code	JetBrains
설치 방법	마켓플레이스 또는 직접 링크	JetBrains 마켓플레이스
그래픽 패널	있음 (기본)	없음 (터미널 기반)
Diff 보기	VS Code 내장	JetBrains 내장 diff 뷰어
플러그인 관리 UI	`/plugins` 명령어로 접근	CLI로 관리
단축키	`Option+K` / `Alt+K`	`Cmd+Option+K` / `Alt+Ctrl+K`
원격 개발	기본 지원	Host에 플러그인 설치 필요

다음 단계

일반 워크플로우 탐색으로 Claude Code를 최대한 활용하기
MCP 서버 설정으로 외부 도구와 데이터베이스에 접근하기
플러그인 탐색으로 Claude Code를 더욱 확장하기
설정 가이드에서 허용된 명령어, 훅, 환경 변수 설정하기
문제가 지속되면 문제 해결 가이드 참조