JetBrains IDE

IntelliJ, PyCharm, WebStorm 등 JetBrains IDE에서 Claude Code 사용하기

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

지원되는 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와 공유됩니다

설치

Marketplace 설치

JetBrains marketplace에서 Claude Code 플러그인을 찾아 설치한 후 IDE를 재시작하세요.

Claude Code를 아직 설치하지 않았다면, 빠른 시작 가이드에서 설치 방법을 확인하세요.

참고: 플러그인 설치 후 적용을 위해 IDE를 완전히 재시작해야 할 수 있습니다.

사용법

IDE에서 사용

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

외부 터미널에서 사용

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

claude

/ide

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

설정

Claude Code 설정

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

1. claude를 실행합니다
2. /config 명령어를 입력합니다
3. 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 command를 wsl -d Ubuntu -- bash -lic "claude"로 설정하세요 (Ubuntu를 사용 중인 WSL 배포판 이름으로 변경)

ESC 키 설정

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

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

이렇게 하면 ESC 키로 Claude Code 작업을 올바르게 중단할 수 있습니다.

특수 설정

원격 개발

주의: JetBrains Remote Development를 사용하는 경우, **Settings → Plugin (Host)**에서 원격 호스트에 플러그인을 설치해야 합니다.

플러그인은 로컬 클라이언트 머신이 아닌 원격 호스트에 설치해야 합니다.

WSL 설정

주의: WSL 사용자는 IDE 감지가 올바르게 작동하려면 추가 설정이 필요할 수 있습니다. 자세한 설정 방법은 WSL 문제 해결 가이드를 참조하세요.

WSL 설정에는 다음이 필요할 수 있습니다:

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

문제 해결

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

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

IDE가 감지되지 않는 경우

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

명령어를 찾을 수 없는 경우

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

1. Claude Code가 설치되어 있는지 확인합니다: npm list -g @anthropic-ai/claude-code
2. 플러그인 설정에서 Claude 명령어 경로를 설정합니다
3. WSL 사용자는 설정 섹션에서 언급된 WSL 명령어 형식을 사용하세요

보안 고려사항

Claude Code가 자동 편집 권한이 활성화된 JetBrains IDE에서 실행될 때, IDE에 의해 자동으로 실행될 수 있는 IDE 설정 파일을 수정할 수 있습니다. 이로 인해 자동 편집 모드에서 Claude Code를 실행하는 위험이 증가하고, bash 실행에 대한 Claude Code의 권한 프롬프트를 우회할 수 있습니다.

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

• 편집에 대해 수동 승인 모드를 사용하세요
• Claude가 신뢰할 수 있는 프롬프트에서만 사용되도록 각별히 주의하세요
• Claude Code가 수정할 수 있는 파일을 파악하고 있으세요

추가 도움이 필요하면 문제 해결 가이드를 참조하세요.