JetBrains 플러그인

들어가며

이전 차시에서 VS Code 확장 프로그램을 살펴봤다. 그래픽 패널, 프롬프트 박스, @-멘션, 체크포인트 같은 기능이 모두 VS Code 안에서 동작한다. JetBrains 사용자도 같은 경험을 기대할 수 있을까.

답은 조금 다르다. JetBrains 플러그인은 VS Code 확장 프로그램처럼 전용 그래픽 패널을 제공하지 않는다. 대신 Claude Code CLI와 IDE를 연결하는 통합 계층으로 동작한다. IDE의 통합 터미널에서 claude를 실행하면 플러그인이 배경에서 선택 영역, 진단 정보, 파일 참조 같은 컨텍스트를 자동으로 공유한다. 변경사항은 IDE의 diff 뷰어로 표시된다.

즉, 인터페이스는 여전히 터미널이지만, IDE의 기능과 유기적으로 연결된다. IntelliJ IDEA, PyCharm, WebStorm 같은 JetBrains 도구의 강점을 유지하면서 Claude Code를 사용할 수 있다.

이번 차시에서는 세 가지를 다룬다. 먼저 지원 IDE와 설치 방법을 살펴본다. 그 다음 플러그인의 주요 통합 기능을 알아본다. 마지막으로 플러그인 설정, Remote Development, WSL 구성, 일반적인 문제 해결 방법을 정리한다.

지원 IDE

Claude Code 플러그인은 대부분의 JetBrains IDE에서 동작한다. 공식 문서에서 확인 가능한 주요 IDE는 다음과 같다.

IntelliJ IDEA
PyCharm
Android Studio
WebStorm
PhpStorm
GoLand

그 외 RubyMine, CLion, Rider, DataGrip 같은 JetBrains 제품에서도 플러그인을 설치해 사용할 수 있다.

플러그인 이름은 JetBrains Marketplace에서 “Claude Code [Beta]“로 표기된다. 현재 Beta 단계이며, 플러그인 페이지의 URL 슬러그에도 beta-가 포함되어 있다.

설치

Marketplace에서 설치

IDE 안에서 직접 설치하는 방법이 가장 간단하다.

IDE 열기
Settings/Preferences → Plugins
Marketplace 탭에서 “Claude Code” 검색
Install 클릭
IDE 재시작

JetBrains Marketplace 웹사이트에서 직접 설치할 수도 있다. 플러그인 페이지에서 Install to IDE를 클릭한다.

플러그인 설치 후에는 IDE를 완전히 재시작해야 한다. 재시작 없이 바로 활성화되지 않는 경우가 있다.

Claude Code CLI 설치 확인

플러그인은 별도의 Claude Code 실행 파일에 의존한다. 플러그인만 설치해서는 동작하지 않는다. CLI를 먼저 설치해야 한다.

CLI 설치 여부는 다음으로 확인한다.

claude --version

설치되어 있지 않다면 Quickstart 가이드의 설치 방법을 따른다. 네이티브 설치 스크립트, Homebrew, WinGet 중 선택할 수 있다.

사용 방법

IDE 내부 터미널에서

가장 기본적인 사용법은 IDE의 통합 터미널에서 claude를 실행하는 것이다.

claude

통합 터미널에서 실행하면 플러그인이 자동으로 감지해서 통합 기능을 활성화한다. 별도의 연결 명령은 필요하지 않다.

외부 터미널에서 연결

외부 터미널(예: iTerm2, Windows Terminal)에서 Claude Code를 실행한 경우 /ide 명령으로 IDE에 연결한다.

claude

Claude Code 세션 안에서 명령을 입력한다.

/ide

명령 실행 후 연결 가능한 IDE 목록이 표시된다. 연결을 선택하면 통합 기능이 활성화된다.

IDE와 같은 파일에 접근하려면 IDE 프로젝트 루트와 동일한 디렉토리에서 Claude Code를 시작해야 한다.

주요 통합 기능

플러그인이 활성화되면 다섯 가지 핵심 기능이 동작한다.

빠른 실행

에디터에서 바로 Claude Code를 열 수 있다.

플랫폼	단축키
macOS	`Cmd+Esc`
Windows/Linux	`Ctrl+Esc`

단축키 대신 UI의 Claude Code 버튼을 클릭해도 된다.

IDE diff 뷰

Claude가 파일을 수정할 때 변경사항이 터미널이 아닌 IDE의 diff 뷰어에 표시된다. JetBrains의 기본 diff 뷰어는 좌우 분할 비교, 변경 하이라이트, 개별 변경 승인/거부를 지원한다. 터미널 출력보다 시각적으로 이해하기 쉽다.

Claude Code 설정에서 diff 도구를 전환할 수 있다. Claude Code를 실행한 뒤 다음 명령을 입력한다.

/config

diff tool 항목에서 auto(IDE에 표시) 또는 terminal(터미널에 표시) 중 선택한다.

선택 영역 컨텍스트

IDE에서 코드를 선택하거나 특정 탭을 활성화하면 Claude에게 자동으로 공유된다. 선택 영역과 현재 탭 정보를 별도로 붙여넣지 않아도 Claude가 문맥을 인식한다.

파일 참조 단축키

파일 참조를 프롬프트에 빠르게 삽입할 수 있다.

플랫폼	단축키
macOS	`Cmd+Option+K`
Linux/Windows	`Alt+Ctrl+K`

단축키를 누르면 @File#L1-99 형식의 참조가 삽입된다. 파일 경로와 선택한 줄 번호가 자동으로 포함된다.

진단 공유

IDE가 표시하는 진단 정보(lint 경고, syntax 에러 등)가 작업 중 자동으로 Claude와 공유된다. Claude가 별도의 파일 검사 없이 현재 문제를 인식할 수 있다.

이 흐름은 JetBrains 통합의 차별점이다. “IDE 진단 감지 → Claude에게 전달 → 수정 제안 → diff 뷰어로 승인”이라는 루프를 자연스럽게 만든다.

플러그인 설정

플러그인의 자체 설정은 **Settings → Tools → Claude Code [Beta]**에서 변경한다.

General Settings

설정	설명
Claude command	Claude 실행에 사용할 명령 경로 (예: `claude`, `/usr/local/bin/claude`, `npx @anthropic-ai/claude-code`)
Suppress notification for Claude command not found	Claude 명령을 찾지 못할 때 알림 비활성화
Enable using Option+Enter for multi-line prompts (macOS only)	Option+Enter로 프롬프트에서 줄바꿈 (터미널 재시작 필요)
Enable automatic updates	플러그인 자동 업데이트 확인 및 설치 (재시작 시 적용)

Claude command 커스터마이징

PATH에 없는 위치에 Claude Code를 설치했다면 Claude command에 전체 경로를 지정한다.

/usr/local/bin/claude

npm 기반 설치를 사용하는 경우 다음처럼 설정할 수도 있다.

npx @anthropic-ai/claude-code

설정을 변경한 뒤에는 터미널이나 IDE 재시작이 필요할 수 있다.

Option+Enter 설정 (macOS)

macOS에서 Option+Enter는 기본 입력 시 여러 줄 프롬프트 입력으로 동작한다. Option 키가 다른 기능(예: 특수 문자 입력)과 충돌하면 설정에서 비활성화할 수 있다. 변경 후 터미널 재시작이 필요하다.

ESC 키 충돌 해결

JetBrains 터미널에서 Esc 키가 Claude Code 작업을 인터럽트하지 않는 경우가 있다. JetBrains의 기본 단축키가 ESC를 “에디터로 포커스 이동”에 할당하기 때문이다.

해결 방법은 터미널 키바인딩을 조정하는 것이다.

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)

로컬 클라이언트에만 플러그인을 설치하면 원격 호스트의 Claude Code CLI와 연결되지 않는다. 원격 호스트에서 IDE 세션을 열고 있는 쪽에 플러그인을 설치해야 통합이 동작한다.

WSL 환경 설정

Windows에서 WSL과 함께 Claude Code를 사용할 때 추가 설정이 필요할 수 있다.

Claude command 설정

WSL에서 Claude Code를 실행하는 경우 플러그인의 Claude command를 다음 형식으로 지정한다.

wsl -d Ubuntu -- bash -lic "claude"

Ubuntu 부분은 사용 중인 WSL 배포판 이름으로 교체한다. wsl --list로 배포판 이름을 확인할 수 있다.

IDE 감지 문제

WSL2에서 JetBrains IDE와 Claude Code를 함께 사용할 때 “No available IDEs detected” 오류가 발생할 수 있다. WSL2의 NAT 네트워킹이나 Windows 방화벽이 연결을 차단하기 때문이다.

해결 방법은 두 가지다.

옵션 1: Windows 방화벽 규칙 추가 (권장)

WSL2 IP 주소 확인

wsl hostname -I
# 예시 출력: 172.21.123.45

PowerShell을 관리자 권한으로 열고 방화벽 규칙 생성

New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

IP 범위는 1단계에서 확인한 WSL2 서브넷에 맞게 조정한다.

IDE와 Claude Code를 모두 재시작

옵션 2: Mirrored 네트워킹 모드로 전환

Windows 사용자 홈 디렉토리(C:\Users\사용자명)의 .wslconfig 파일에 다음을 추가한다.

[wsl2]
networkingMode=mirrored

PowerShell에서 wsl --shutdown으로 WSL을 재시작한다.

참고로 이 네트워킹 이슈는 WSL2에만 해당된다. WSL1은 호스트 네트워크를 직접 사용하므로 추가 설정이 필요하지 않다.

보안 고려사항

Claude Code가 JetBrains IDE에서 auto-edit 권한으로 실행되면 IDE 설정 파일을 수정할 수 있다. IDE는 일부 설정 파일을 자동으로 실행하거나 적용한다. 이는 auto-edit 모드 실행 시 위험을 증가시키고, bash 실행에 대한 권한 프롬프트를 우회할 가능성을 만든다.

JetBrains 환경에서 고려할 점:

수동 승인 모드 사용: 신뢰할 수 없는 코드베이스에서는 각 편집을 수동으로 승인한다
프롬프트 신뢰 관리: Claude는 받은 프롬프트에 따라 동작한다. 외부에서 가져온 프롬프트를 그대로 실행하지 않는다
수정 범위 인식: Claude가 수정할 수 있는 파일 범위를 확인하고 민감한 설정 파일을 보호한다

문제 해결

플러그인이 동작하지 않을 때

IDE 프로젝트 루트와 같은 디렉토리에서 Claude Code를 실행하는지 확인
Settings → Plugins에서 Claude Code 플러그인이 활성화되어 있는지 확인
IDE를 완전히 재시작 (여러 번 필요할 수 있음)
Remote Development는 원격 호스트 쪽 플러그인 설치 여부 확인

IDE가 감지되지 않을 때

플러그인이 설치되고 활성화되어 있는지 확인
IDE를 완전히 재시작
IDE의 통합 터미널에서 Claude Code를 실행하는지 확인 (외부 터미널은 /ide 필요)
WSL 사용자는 위의 WSL 섹션 참고

”Command not found”가 표시될 때

Claude 아이콘을 클릭했을 때 “command not found” 오류가 나타나면 플러그인이 Claude 실행 파일을 찾지 못한 상태다.

CLI 설치 확인

npm list -g @anthropic-ai/claude-code

또는

which claude

플러그인 설정의 Claude command에 실제 경로 입력
WSL 사용자는 WSL 명령 형식(wsl -d Ubuntu -- bash -lic "claude") 사용

정리

핵심 요점

통합 계층: JetBrains 플러그인은 전용 UI가 아니라 CLI와 IDE를 연결하는 통합 계층이다. 인터페이스는 터미널이지만 IDE 기능이 유기적으로 연결된다
통합 기능 5가지: 빠른 실행 단축키(Cmd/Ctrl+Esc), IDE diff 뷰, 선택 영역 자동 공유, 파일 참조 단축키(Cmd+Option+K / Alt+Ctrl+K), 진단 자동 공유
터미널 방식: IDE 통합 터미널에서 claude를 실행하면 자동 감지된다. 외부 터미널은 /ide 명령으로 연결한다
WSL 설정: Claude command를 WSL 호출 형식으로 설정하고, WSL2의 경우 방화벽 규칙이나 mirrored 네트워킹 모드로 IDE 감지 문제를 해결한다
Remote Development: 플러그인은 로컬 클라이언트가 아닌 원격 호스트에 설치해야 한다
ESC 키 충돌: Settings → Tools → Terminal에서 “Move focus to the editor with Escape”를 해제해 인터럽트 기능을 복구한다

확인해볼 링크

다음 단계

다음 차시에서는 CLAUDE.md 프로젝트 지침을 다룬다. Claude Code가 프로젝트 컨텍스트를 이해하도록 돕는 CLAUDE.md 파일을 작성하고, 코딩 규칙과 아키텍처 정보를 정의하는 방법을 살펴본다.