Claude Code는 전용 플러그인을 통해 JetBrains IDE와 통합되며, 대화형 diff 보기, 선택 영역 컨텍스트 공유 등의 기능을 제공합니다.Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
지원되는 IDE
Claude Code 플러그인은 다음을 포함한 대부분의 JetBrains IDE와 호환됩니다:- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
기능
- 빠른 실행:
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)를 사용하여@src/auth.ts#L1-99와 같은 파일 참조를 삽입합니다 - 진단 공유: IDE의 진단 오류 (lint 및 구문 오류 등)가 작업할 때 Claude와 자동으로 공유됩니다
설치
마켓플레이스 설치
JetBrains 마켓플레이스에서 Claude Code 플러그인을 찾아 설치하고 IDE를 다시 시작합니다. Claude Code를 아직 설치하지 않았다면, 빠른 시작 가이드에서 설치 지침을 참조하세요.플러그인을 설치한 후 IDE를 완전히 다시 시작해야 적용될 수 있습니다.
사용법
IDE에서
IDE의 통합 터미널에서claude를 실행하면 모든 통합 기능이 활성화됩니다.
외부 터미널에서
모든 외부 터미널에서/ide 명령을 사용하여 Claude Code를 JetBrains IDE에 연결하고 모든 기능을 활성화합니다:
구성
Claude Code 설정
Claude Code의 설정을 통해 IDE 통합을 구성합니다:claude실행/config명령 입력- diff 도구를
auto로 설정하여 IDE에서 diff를 표시하거나,terminal로 설정하여 터미널에 유지합니다
플러그인 설정
**설정 → 도구 → Claude Code [Beta]**로 이동하여 Claude Code 플러그인을 구성합니다:일반 설정
- Claude 명령: Claude를 실행할 사용자 정의 명령을 지정합니다 (예:
claude,/usr/local/bin/claude, 또는npx @anthropic-ai/claude-code) - Claude 명령을 찾을 수 없음에 대한 알림 표시 안 함: Claude 명령을 찾을 수 없다는 알림을 건너뜁니다
- 다중 줄 프롬프트에 Option+Enter 사용 활성화: macOS만 해당합니다. 활성화되면 Option+Enter가 Claude Code 프롬프트에 새 줄을 삽입합니다. Option 키가 예기치 않게 캡처되는 문제가 발생하면 비활성화합니다. 터미널 다시 시작이 필요합니다.
- 자동 업데이트 활성화: 플러그인 업데이트를 자동으로 확인하고 설치합니다. 다시 시작 시 적용됩니다.
ESC 키 구성
ESC 키가 JetBrains 터미널에서 Claude Code 작업을 중단하지 않는 경우:- 설정 → 도구 → 터미널로 이동합니다
- 다음 중 하나를 수행합니다:
- “Escape로 편집기에 포커스 이동” 선택 해제, 또는
- “터미널 키 바인딩 구성”을 클릭하고 “편집기로 포커스 전환” 바로가기 삭제
- 변경 사항을 적용합니다
특수 구성
원격 개발
플러그인은 로컬 클라이언트 머신이 아닌 원격 호스트에 설치해야 합니다.WSL 구성
Claude Code를 WSL2의 JetBrains IDE와 함께 사용하고 “사용 가능한 IDE가 감지되지 않음”이 표시되는 경우, 원인은 일반적으로 WSL2의 NAT 네트워킹 또는 Windows 방화벽이 WSL2와 Windows 호스트에서 실행 중인 IDE 간의 연결을 차단하기 때문입니다. WSL1은 호스트의 네트워크를 직접 사용하므로 영향을 받지 않습니다.Windows 방화벽을 통해 WSL2 트래픽 허용
이것이 권장되는 해결책입니다. 기존 WSL2 네트워킹 모드를 유지하기 때문입니다.WSL2를 미러링된 네트워킹으로 전환
미러링된 네트워킹에는 Windows 11 22H2 이상이 필요합니다. Windows 10을 사용 중이면 대신 위의 방화벽 규칙을 사용합니다. Windows 사용자 디렉터리의.wslconfig에 다음을 추가합니다:
wsl --shutdown으로 WSL을 다시 시작합니다.
문제 해결
플러그인이 작동하지 않음
플러그인이 설치되었지만 Claude Code 기능이 IDE에 나타나지 않는 경우:- 프로젝트 루트 디렉터리에서 Claude Code를 실행 중인지 확인합니다
- JetBrains 플러그인이 IDE 설정에서 활성화되어 있는지 확인합니다
- IDE를 완전히 다시 시작합니다 (여러 번 수행해야 할 수 있습니다)
- 원격 개발의 경우 플러그인이 원격 호스트에 설치되어 있는지 확인합니다
IDE가 감지되지 않음
claude 실행 시 “사용 가능한 IDE가 감지되지 않음”이 표시되는 경우:
- 플러그인이 설치되고 활성화되어 있는지 확인합니다
- IDE를 완전히 다시 시작합니다
- 통합 터미널에서 Claude Code를 실행 중인지 확인합니다
- WSL 사용자의 경우 위의 WSL 구성을 참조하세요
명령을 찾을 수 없음
Claude 아이콘을 클릭하면 “명령을 찾을 수 없음”이 표시되는 경우:- Claude Code가 설치되어 있는지 확인합니다:
claude --version을 터미널에서 실행합니다 - 플러그인 설정에서 Claude 명령 경로를 구성합니다
- WSL 사용자의 경우 구성 섹션에서 언급한 WSL 명령 형식을 사용합니다
보안 고려 사항
Claude Code가 자동 편집 권한이 활성화된 JetBrains IDE에서 실행될 때, IDE에서 자동으로 실행될 수 있는 IDE 구성 파일을 수정할 수 있습니다. 이는 자동 편집 모드에서 Claude Code를 실행하는 위험을 증가시킬 수 있으며 bash 실행에 대한 Claude Code의 권한 프롬프트를 우회할 수 있습니다. JetBrains IDE에서 실행할 때 다음을 고려합니다:- 편집에 대한 수동 승인 모드 사용
- Claude가 신뢰할 수 있는 프롬프트로만 사용되도록 각별히 주의
- Claude Code가 수정할 수 있는 파일이 무엇인지 인식