클로드 코드 인텔리제이 연동 — 플러그인 설치와 안 될 때

클로드 코드 인텔리제이 연동은 플러그인 하나만 깐다고 되지 않습니다. ① 터미널에 claude CLI 를 먼저 설치하고, ② 인텔리제이 마켓플레이스에서 Claude Code [Beta] 플러그인을 설치한 뒤 IDE 를 완전히 재시작하면 됩니다. 마켓플레이스에서 검색해도 안 나온다면 대부분 IDE 버전이 2024.2 보다 낮은 경우입니다. 아래는 2026년 8월 6일 기준(플러그인 0.1.14-beta · CLI 2.1.202)으로 확인한 설치 순서와 안 될 때 확인할 것들입니다.

1. 클로드 코드 인텔리제이 연동 — 두 가지를 따로 설치한다

가장 많이 헷갈리는 지점입니다. 플러그인은 CLI 를 품고 있지 않습니다. 공식 문서는 이렇게 못 박습니다 — "The plugin runs the claude command in your IDE's integrated terminal and connects to it. It does not bundle its own copy of the CLI." 즉 플러그인은 IDE 내장 터미널에서 claude 명령을 대신 실행해 주고, 그 세션에 붙는 역할입니다.

순서	할 일	확인 방법
①	터미널에 Claude Code CLI 설치	claude --version 이 버전을 뱉으면 성공
②	마켓플레이스에서 Claude Code [Beta] 설치	Settings → Plugins → Marketplace 에서 검색
③	IDE 완전 재시작	내장 터미널에서 claude 실행

①번이 아직이라면 클로드 코드 설치 — mac·윈도우 명령어 글의 순서를 먼저 밟으세요. CLI 가 PATH 에 없으면 플러그인은 "Cannot launch Claude Code" 알림을 띄웁니다.

설치가 끝났는지 확인하는 명령은 이 한 줄입니다.

claude --version
# 2.1.202 (Claude Code)

💡 API 키는 필요 없습니다. Pro·Max·Team·Enterprise 같은 유료 Claude 구독이나 Claude Console 계정이면 되고, 처음 claude 를 실행할 때 로그인 화면이 뜹니다.

2. 마켓플레이스에서 플러그인이 검색해도 안 나올 때 (2024.2 미만)

가장 흔한 원인은 IDE 버전입니다. 플러그인의 since-build 가 242.0 으로 잡혀 있어서, 2024.2 미만 IDE 에서는 마켓플레이스 목록 자체에 뜨지 않습니다. "설치가 안 된다"가 아니라 "검색 결과에 없다"로 나타나기 때문에 오타를 의심하며 시간을 버리기 쉽습니다.

IDE 가 실제로 조회하는 플러그인 저장소에 내 IDE 빌드 번호를 그대로 넣어 보면 확인됩니다. 2023.3(빌드 IU-233…)으로 물으면 빈 응답이 옵니다.

# 2023.3 (IU-233) — 결과 없음
curl -s "https://plugins.jetbrains.com/plugins/list?pluginId=com.anthropic.code.plugin&build=IU-233.13135.103"
<?xml version='1.0' encoding='UTF-8'?><plugin-repository/>

# 2025.1 (IU-251) — 정상 응답
curl -s "https://plugins.jetbrains.com/plugins/list?pluginId=com.anthropic.code.plugin&build=IU-251.23774.435"
<?xml …><plugin-repository>… <version>0.1.14-beta</version> …

내 IDE 빌드 번호는 Help → About 에서 볼 수 있습니다. 제품별 최소 버전은 아래와 같습니다.

IDE	최소 버전
IntelliJ IDEA (Ultimate·Community)	2024.2 이상
PyCharm · WebStorm · PhpStorm · GoLand · RubyMine · CLion · Rider	2024.2 이상
Android Studio	Ladybug (2024.2.1) 이상

검색어도 확인하세요. 마켓플레이스에 등록된 이름은 Claude Code [Beta] 입니다(플러그인 ID com.anthropic.code.plugin). 2026년 8월 6일 기준 최신 버전은 0.1.14-beta(2025-12-05 배포)이고, 누적 다운로드는 450만 회를 넘겼습니다.

3. 연결 확인 — 내장 터미널이면 자동, 외부 터미널이면 /ide

연결 방법은 두 가지입니다.

• IDE 내장 터미널에서 claude 실행 — 별도 명령 없이 연동 기능이 모두 켜집니다.
• 외부 터미널에서 실행했다면 /ide — 공식 명령 목록에도 "Manage IDE integrations and show status"로 올라 있는 슬래시 명령입니다.

claude

# 세션이 뜨면 프롬프트에 입력
/ide

연결에 성공하면 Connected to IntelliJ IDEA. 같은 메시지가 뜹니다. 플러그인이 없는 IDE 가 떠 있으면 /ide 가 플러그인을 대신 설치하고 재시작을 요청합니다. 다른 슬래시 명령은 클로드 코드 슬래시 명령어 정리 글에 모아 두었습니다.

⚠️ Claude 가 IDE 와 같은 파일을 보게 하려면 IDE 프로젝트 루트와 같은 디렉터리에서 클로드 코드를 시작해야 합니다. 하위 폴더에서 띄우면 그 위 파일들은 보지 못합니다.

4. 연동하면 달라지는 것 — 단축키와 diff

기능	내용
빠른 실행	Cmd+Esc(맥) · Ctrl+Esc(윈도우·리눅스)
파일 참조 삽입	Cmd+Option+K(맥) · Alt+Ctrl+K(윈도우·리눅스) → @src/auth.ts#L1-99 형태로 들어감
diff 보기	터미널 대신 IDE 의 diff 뷰어로 열림 (/config 의 Diff tool 로 auto/terminal 전환)
선택 영역 공유	에디터에서 선택한 코드와 열려 있는 탭이 프롬프트에 자동으로 따라붙음
진단 공유	IDE 의 lint·문법 오류가 대화에 자동 전달됨

/config 의 Diff tool 항목은 IDE 에 연결된 상태에서만 나타납니다. 안 보인다면 아직 연결이 안 된 것이니 3번을 다시 확인하세요.

선택 영역이 넘어가는 게 부담스러운 파일(.env 등)은 Read deny 규칙으로 막을 수 있습니다. 거부 규칙에 걸린 파일은 선택한 텍스트도, 열려 있다는 사실도 전달되지 않습니다. 권한 규칙을 쓰는 법은 클로드 코드 권한 설정 — 모드 6가지 글에 정리해 두었습니다.

5. 인텔리제이 연동이 안 될 때 체크리스트

증상	확인할 것
마켓플레이스에 안 보임	IDE 가 2024.2 미만인지 (2번 항목)
"command not found"	claude --version 확인 → 안 되면 Settings → Tools → Claude Code [Beta] 의 Claude command 에 전체 경로 입력
"No available IDEs detected"	플러그인 활성화 여부 · IDE 완전 재시작 · (WSL2 라면 아래 참고)
ESC 로 중단이 안 됨	Settings → Tools → Terminal 에서 "Move focus to the editor with Escape" 체크 해제
원격 개발에서 안 됨	플러그인을 로컬이 아니라 Settings → Plugin (Host) 로 원격 호스트에 설치

WSL2 에서 "No available IDEs detected" 가 뜨는 경우는 대개 WSL2 의 NAT 네트워킹이나 윈도우 방화벽이 WSL2 ↔ 윈도우 호스트 IDE 연결을 막은 것입니다(WSL1 은 호스트 네트워크를 그대로 써서 해당 없음). WSL 셸에서 hostname -I 로 주소를 확인해 앞 두 자리로 서브넷을 잡고, 관리자 권한 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

윈도우 11 22H2 이상이면 미러 네트워킹으로 바꾸는 방법도 있습니다. 사용자 폴더의 .wslconfig 에 아래를 넣고 wsl --shutdown 으로 재시작합니다.

[wsl2]
networkingMode=mirrored

WSL 환경이라면 플러그인 설정의 Claude command 도 WSL 형식으로 넣어야 합니다.

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

6. 보안에서 알아둘 것

공식 문서가 JetBrains 환경에 대해 따로 경고하는 부분이 있습니다. acceptEdits 권한 모드로 돌리면 클로드가 IDE 설정 파일까지 수정할 수 있고, 그 파일은 IDE 가 자동으로 실행할 수 있습니다. 그 경로로 bash 실행 권한 확인을 우회당할 여지가 생깁니다. JetBrains IDE 안에서는 편집을 수동 승인 모드로 두는 편이 안전합니다.

자주 묻는 질문 (FAQ)

Q. 커뮤니티 에디션에서도 되나요?
됩니다. 플러그인 호환 목록에 IntelliJ IDEA Community 2024.2 이상이 포함돼 있습니다.

Q. 안드로이드 스튜디오에서도 쓸 수 있나요?
쓸 수 있습니다. 다만 최소 버전이 다릅니다 — Ladybug(2024.2.1) 이상이어야 마켓플레이스에 노출됩니다.

Q. API 키를 따로 발급받아야 하나요?
아닙니다. 유료 Claude 구독(Pro·Max·Team·Enterprise)이나 Claude Console 계정으로 로그인하면 됩니다.

Q. VS Code 연동과 뭐가 다른가요?
기능은 대체로 같습니다(diff 뷰어·선택 영역 공유·진단 전달). 설치 경로와 단축키, 그리고 ESC 키 설정 같은 IDE 고유 항목이 다릅니다. VS Code 쪽은 클로드 코드 vscode 연동 글을 참고하세요.

Q. 플러그인을 깔았는데 아무 변화가 없습니다.
프로젝트 루트에서 실행했는지, 플러그인이 활성화돼 있는지 확인하고 IDE 를 완전히 재시작하세요. 공식 문서도 재시작을 여러 번 해야 할 수 있다고 안내합니다.

마무리

정리하면 CLI 설치 → 플러그인 설치 → 완전 재시작 → 내장 터미널에서 claude(또는 외부 터미널에서 /ide) 순서입니다. 안 될 때 가장 먼저 볼 것은 IDE 버전(2024.2 미만이면 검색조차 안 됨)과 claude --version 두 가지입니다. 플러그인은 아직 베타 단계라 버전이 자주 오르니, 설치 전에 마켓플레이스 페이지에서 현재 버전과 호환 범위를 한 번 확인하세요.

---

📚 참고 출처 (2026년 8월 6일 확인)
· Claude Code 공식 문서 — JetBrains IDEs
· Claude Code 공식 문서 — Slash commands
· JetBrains Marketplace — Claude Code [Beta]