지원되는 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)를 사용하여 파일 참조를 삽입합니다 (예: @File#L1-99) - 진단 공유: IDE의 진단 오류 (lint, 구문 등)가 작업할 때 Claude와 자동으로 공유됩니다
설치
마켓플레이스 설치
JetBrains 마켓플레이스에서 Claude Code 플러그인을 찾아 설치하고 IDE를 다시 시작합니다.자동 설치
통합 터미널에서claude를 실행할 때 플러그인이 자동으로 설치될 수도 있습니다. IDE를 완전히 다시 시작해야 적용됩니다.
플러그인을 설치한 후 IDE를 완전히 다시 시작해야 적용됩니다. 여러 번 다시 시작해야 할 수도 있습니다.
사용
IDE에서
IDE의 통합 터미널에서claude를 실행하면 모든 통합 기능이 활성화됩니다.
외부 터미널에서
모든 외부 터미널에서/ide 명령을 사용하여 Claude Code를 JetBrains IDE에 연결하고 모든 기능을 활성화합니다:
구성
Claude Code 설정
Claude Code의 설정을 통해 IDE 통합을 구성합니다:claude실행/config명령 입력- diff 도구를
auto로 설정하여 자동 IDE 감지
플러그인 설정
**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만 해당): 활성화되면 Option+Enter가 Claude Code 프롬프트에 새 줄을 삽입합니다. Option 키가 예기치 않게 캡처되는 문제가 발생하면 비활성화합니다 (터미널 다시 시작 필요)
- 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” 바로가기를 삭제합니다
- 변경 사항을 적용합니다
특수 구성
원격 개발
JetBrains 원격 개발을 사용할 때는 **Settings → Plugin (Host)**를 통해 원격 호스트에 플러그인을 설치해야 합니다.
WSL 구성
WSL 사용자는 IDE 감지가 제대로 작동하도록 추가 구성이 필요할 수 있습니다. 자세한 설정 지침은 WSL 문제 해결 가이드를 참조하세요.
- 적절한 터미널 구성
- 네트워킹 모드 조정
- 방화벽 설정 업데이트
문제 해결
플러그인이 작동하지 않음
- 프로젝트 루트 디렉터리에서 Claude Code를 실행 중인지 확인합니다
- JetBrains 플러그인이 IDE 설정에서 활성화되어 있는지 확인합니다
- IDE를 완전히 다시 시작합니다 (여러 번 수행해야 할 수 있습니다)
- 원격 개발의 경우 플러그인이 원격 호스트에 설치되어 있는지 확인합니다
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를 실행하는 위험을 증가시킬 수 있으며 bash 실행에 대한 Claude Code의 권한 프롬프트를 우회할 수 있습니다. JetBrains IDE에서 실행할 때 다음을 고려합니다:- 편집에 대한 수동 승인 모드 사용
- Claude가 신뢰할 수 있는 프롬프트에서만 사용되도록 각별히 주의
- Claude Code가 수정할 수 있는 파일을 인식합니다