JetBrains에서 Claude Code 사용하기: CLI, 플러그인, 설정
IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Android Studio에서 AI in IDE API 키 하나로 Claude Code를 사용합니다.
JetBrains에는 채팅을 내장한 확장이 없습니다. 플러그인이 IDE 터미널에서 claude CLI를 실행하고 로컬 소켓으로 연결하므로, CLI와 플러그인, CLI 환경 설정이 모두 필요합니다. 전체 참고 자료는 JetBrains에서 Claude Code 사용하기를 보세요.
빠른 설정
- CLI 설치. npm으로 설치할 때는 Node.js 22 이상이 필요하고, 네이티브 CLI는 Node.js 없이 동작합니다.
1 npm install -g @anthropic-ai/claude-code2 claude --version
일반 터미널에서 claude가 해석되는지 확인합니다. 안 되면 플러그인이 실행할 수 없습니다.
- 플러그인 설치. Settings → Plugins → Marketplace를 열고 Claude Code를 검색해 설치한 뒤 IDE를 완전히 재시작합니다. Remote Development에서는 **Settings → Plugin (Host)**로 호스트에 설치하세요.
- 플러그인에 CLI 알려 주기. Settings → Tools → Claude Code [Beta] → Claude command는 명령 문자열을 받습니다. PATH의
claude,/usr/local/bin/claude같은 절대 경로,npx @anthropic-ai/claude-code, WSL이면wsl -d Ubuntu -- bash -lic "claude"를 넣습니다. - 연결 설정 작성. CLI는
~/.claude/settings.json(macOS/Linux) 또는C:/Users/<UserName>/.claude/settings.json(Windows)을 읽습니다.
1 {2 "$schema": "https://json.schemastore.org/claude-code-settings.json",3 "env": {4 "ANTHROPIC_BASE_URL": "https://api.aiinide.com",5 "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",6 "API_TIMEOUT_MS": "600000",7 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"8 }9 }
ANTHROPIC_BASE_URL은 호스트 이름만 넣습니다. CLI가 /v1/messages를 붙입니다. ANTHROPIC_AUTH_TOKEN이 있으면 첫 실행 로그인 화면을 건너뜁니다.
- 확인. IDE 통합 터미널에서
claude를 실행해 로그인 화면이 없는지 확인합니다. 이어서/status를 실행하거나Cmd+Esc/Ctrl+Esc로 플러그인을 연결합니다. IDE 밖에서 시작한 터미널이라면/ide를 실행해Connected to IntelliJ IDEA.(IDE 이름)를 확인합니다.
JetBrains 통합의 차이
| VS Code / Cursor | JetBrains | |
|---|---|---|
| 설치 항목 | CLI를 내장한 확장 하나 | CLI 그리고 플러그인 |
| 채팅 위치 | 편집기 안의 네이티브 패널 | IDE 터미널, diff는 IDE에 표시 |
| Claude 탐색 | 내장 바이너리 | PATH의 claude, 또는 설정에서 지정한 경로 |
| 연결 방식 | 확장 프로세스 | 플러그인이 로컬 MCP 서버를 띄우고 CLI가 무작위 loopback 포트로 ws:// 접속 |
네트워크와 대화하는 주체가 CLI이므로 AI in IDE 설정은 CLI에 속하고 플러그인 GUI에는 없습니다. ~/.claude/settings.json 하나로 CLI, 플러그인, 터미널 세션이 모두 설정됩니다.
지원 모델
| 모델 | 채널 | 적합한 용도 |
|---|---|---|
claude-opus-5-5(별칭 claude-opus-5.5) | AWSQ, CCMAX | 다중 파일 리팩터링, 긴 자율 작업 |
claude-sonnet-5-5(별칭 claude-sonnet-5.5) | AWSQ, CCMAX | 일상 작업 기본 |
claude-haiku-4-5-20251001 | AWSQ, CCMAX | 빠르고 저렴한 수정과 확인 |
GET /v1/models의 정확한 ID를 사용하세요. 잘못된 claude-* 이름은 기본 Claude 모델로 해석되어 그 요율로 청구될 수 있습니다. 플랜과 현재 요율은 요금을 보세요.
문제 해결 요점
Cannot launch Claude Code—claude가 IDE PATH에 없습니다. Claude command를 절대 경로나npx @anthropic-ai/claude-code로 설정하세요.No available IDEs detected— 플러그인이 비활성화됐거나 IDE가 완전히 재시작되지 않았거나 CLI가 다른 사용자 세션에 있습니다. WSL2에서는 WSL 서브넷을 방화벽에서 허용하거나networkingMode=mirrored를 쓰세요.- diff가 안 보임 — IDE에 연결된 상태에서
/config로 Diff tool을auto로 설정합니다. Esc로 Claude를 중단할 수 없음 — Settings → Tools → Terminal에서 Move focus to the editor with Escape를 해제합니다.- Remote Development 기능 누락 — 플러그인이 호스트가 아니라 클라이언트에 설치되어 있습니다.
자주 묻는 질문
왜 원클릭 설정이 없나요?
플러그인은 의도적으로 CLI를 내장하지 않습니다. 설치된 claude를 실행해 터미널과 IDE가 하나의 설정을 공유하므로, CLI를 먼저 설치하고 플러그인을 나중에 설치해야 합니다.
VS Code 확장을 재사용할 수 있나요?
아닙니다. VS Code와 Cursor 확장은 별도 제품입니다. 재사용할 수 있는 것은 ~/.claude/settings.json이고, 양쪽 모두 이를 읽습니다.
플러그인에 Anthropic 로그인이 필요한가요?
아닙니다. ANTHROPIC_AUTH_TOKEN과 ANTHROPIC_BASE_URL을 설정하면 CLI가 로그인 화면을 건너뛰고 AI in IDE로 요청을 보냅니다.
어떤 IDE를 지원하나요?
IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand, Android Studio가 문서화되어 있습니다. 같은 플랫폼의 다른 제품도 자주 동작하지만 플러그인은 beta이므로 diff와 /ide를 확인한 뒤 의존하세요.