JetBrains IDEs

Gunakan Claude Code dengan JetBrains IDEs termasuk IntelliJ, PyCharm, WebStorm, dan lainnya

Claude Code terintegrasi dengan JetBrains IDEs melalui plugin khusus, menyediakan fitur seperti tampilan diff interaktif, berbagi konteks seleksi, dan lainnya.

IDE yang Didukung

Plugin Claude Code bekerja dengan sebagian besar JetBrains IDEs, termasuk:

• IntelliJ IDEA
• PyCharm
• Android Studio
• WebStorm
• PhpStorm
• GoLand

Fitur

• Peluncuran cepat: gunakan Cmd+Esc (Mac) atau Ctrl+Esc (Windows/Linux) untuk membuka Claude Code langsung dari editor Anda, atau klik tombol Claude Code di UI
• Tampilan diff: Claude Code membuka perubahan kode di penampil diff IDE alih-alih di terminal; ubah ini dengan pengaturan Diff tool di /config
• Konteks seleksi: seleksi atau tab saat ini di IDE secara otomatis dibagikan dengan Claude Code. Aturan deny Read memblokir pembagian ini untuk file yang cocok
• Pintasan referensi file: gunakan Cmd+Option+K (Mac) atau Alt+Ctrl+K (Linux/Windows) untuk menyisipkan referensi file seperti @src/auth.ts#L1-99
• Berbagi diagnostik: Claude membaca diagnostik inspeksi IDE, seperti kesalahan lint dan sintaks, dengan memanggil tool getDiagnostics; Claude Code tidak meminta diagnostik dari plugin dengan sendirinya setelah pengeditan

Instalasi

Plugin menjalankan perintah claude di terminal terintegrasi IDE Anda dan terhubung dengannya. Plugin tidak menyertakan salinan CLI-nya sendiri, jadi instal kedua bagian:

1. Instal Claude Code CLI

Ikuti mulai cepat untuk menginstal CLI jika Anda belum melakukannya. Plugin menampilkan notifikasi "Cannot launch Claude Code" ketika claude tidak ada di PATH Anda.

2. Instal plugin JetBrains

Instal plugin Claude Code dari JetBrains Marketplace dan mulai ulang IDE Anda.

[!NOTE]

JetBrains Marketplace adalah perangkat lunak pihak ketiga yang tidak didukung, dipelihara, atau diaudit oleh Anthropic. Anthropic mengajukan plugin Claude Code untuk dipublikasikan di JetBrains Marketplace.

Jika claude diinstal di tempat yang tidak dapat ditemukan IDE Anda, atur jalur lengkap di pengaturan perintah Claude plugin.

Claude Code bekerja dengan langganan Claude berbayar apa pun (Pro, Max, Ultra, Team, atau Enterprise) atau akun Claude Console, dan tidak ada kunci API yang diperlukan. Anda akan diminta untuk masuk pertama kali Anda menjalankan claude.

Penggunaan

Menjalankan Claude Code dari IDE Anda

Jalankan claude dari terminal terintegrasi IDE Anda, dan semua fitur integrasi akan aktif.

Menghubungkan dari terminal eksternal

Gunakan perintah /ide di terminal eksternal apa pun untuk menghubungkan Claude Code ke JetBrains IDE Anda dan mengaktifkan semua fitur:

claude

/ide

Ketika koneksi berhasil, Claude Code mengonfirmasi dengan pesan seperti Connected to IntelliJ IDEA.

Jika Anda ingin Claude memiliki akses ke file yang sama dengan IDE Anda, mulai Claude Code dari direktori yang sama dengan root proyek IDE Anda.

Konfigurasi

Pengaturan Claude Code

Konfigurasikan integrasi IDE melalui pengaturan Claude Code:

1. Jalankan claude
2. Masukkan perintah /config
3. Atur alat diff ke auto untuk menampilkan diff di IDE, atau terminal untuk menyimpannya di terminal

Entri alat diff muncul di /config hanya ketika Claude Code terhubung ke IDE, jadi jalankan claude dari terminal JetBrains atau jalankan /ide terlebih dahulu dari terminal eksternal. Lihat diffTool untuk pengaturan yang mendasarinya.

Pengaturan Plugin

Konfigurasikan plugin Claude Code dengan membuka Settings → Tools → Claude Code [Beta]:

Pengaturan Umum

• Perintah Claude: Tentukan perintah khusus untuk menjalankan Claude, misalnya claude, /usr/local/bin/claude, atau npx @anthropic-ai/claude-code
• Tekan notifikasi untuk perintah Claude tidak ditemukan: Lewati notifikasi tentang tidak menemukan perintah Claude
• Aktifkan penggunaan Option+Enter untuk prompt multi-baris: Hanya di macOS. Ketika diaktifkan, Option+Enter menyisipkan baris baru dalam prompt Claude Code. Nonaktifkan jika tombol Option ditangkap secara tidak terduga. Memerlukan restart terminal.
• Aktifkan pembaruan otomatis: Secara otomatis periksa dan instal pembaruan plugin, diterapkan saat restart

[!TIP]

Untuk pengguna WSL: Atur wsl -d Ubuntu -- bash -lic "claude" sebagai perintah Claude Anda (ganti Ubuntu dengan nama distribusi WSL Anda)

Konfigurasi Tombol ESC

Jika tombol ESC tidak menghentikan operasi Claude Code di terminal JetBrains:

1. Buka Settings → Tools → Terminal
2. Salah satu dari:
   • Batalkan centang "Pindahkan fokus ke editor dengan Escape", atau
   • Klik "Konfigurasikan pintasan keyboard terminal" dan hapus pintasan "Alihkan fokus ke Editor"
3. Terapkan perubahan

Ini memungkinkan tombol ESC untuk dengan benar menghentikan operasi Claude Code.

Konfigurasi Khusus

Pengembangan Jarak Jauh

[!WARNING]

Saat menggunakan JetBrains Remote Development, Anda harus menginstal plugin di host jarak jauh melalui Settings → Plugin (Host), bukan di mesin klien lokal Anda.

Konfigurasi WSL

Jika Anda menggunakan Claude Code di WSL2 dengan JetBrains IDE dan melihat "No available IDEs detected", penyebabnya biasanya adalah jaringan NAT WSL2 atau Windows Firewall yang memblokir koneksi antara WSL2 dan IDE yang berjalan di host Windows. WSL1 menggunakan jaringan host secara langsung dan tidak terpengaruh.

Izinkan lalu lintas WSL2 melalui Windows Firewall

Ini adalah perbaikan yang direkomendasikan karena mempertahankan mode jaringan WSL2 yang ada.

1. Temukan alamat IP WSL2 Anda

Dari dalam shell WSL Anda, jalankan:

hostname -I

Catat subnet Anda: ambil dua segmen pertama dari alamat dan ikuti dengan .0.0/16. Misalnya, jika alamatnya adalah 172.21.123.45, subnet Anda adalah 172.21.0.0/16.

2. Buat aturan firewall

Buka PowerShell sebagai Administrator dan jalankan yang berikut, sesuaikan rentang IP untuk mencocokkan subnet Anda:

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

3. Mulai ulang IDE dan Claude Code Anda

Tutup dan buka kembali keduanya agar aturan baru berlaku.

Alihkan WSL2 ke jaringan mirrored

Jaringan mirrored memerlukan Windows 11 22H2 atau lebih baru. Jika Anda menggunakan Windows 10, gunakan aturan firewall di atas.

Tambahkan ini ke .wslconfig di direktori pengguna Windows Anda:

[wsl2]
networkingMode=mirrored

Kemudian mulai ulang WSL dengan wsl --shutdown dari PowerShell.

Troubleshooting

Plugin tidak berfungsi

Jika plugin diinstal tetapi fitur Claude Code tidak muncul di IDE Anda:

• Pastikan Anda menjalankan Claude Code dari direktori root proyek
• Periksa bahwa plugin JetBrains diaktifkan dalam pengaturan IDE
• Mulai ulang IDE sepenuhnya (Anda mungkin perlu melakukan ini beberapa kali)
• Untuk Remote Development, pastikan plugin diinstal di host jarak jauh

IDE tidak terdeteksi

Jika perintah /ide menunjukkan "No available IDEs detected":

• Verifikasi plugin diinstal dan diaktifkan
• Mulai ulang IDE sepenuhnya
• Jika Anda mengharapkan koneksi otomatis tanpa menjalankan /ide, periksa bahwa Anda meluncurkan claude dari terminal terintegrasi IDE
• Untuk pengguna WSL, lihat konfigurasi WSL di atas

Perintah tidak ditemukan

Jika mengklik ikon Claude menunjukkan "command not found":

1. Verifikasi Claude Code diinstal dengan menjalankan claude --version di terminal
2. Konfigurasikan jalur perintah Claude dalam pengaturan plugin
3. Untuk pengguna WSL, gunakan format perintah WSL yang disebutkan di bagian konfigurasi

Pertimbangan keamanan

Ketika Claude Code berjalan di JetBrains IDE dalam mode izin acceptEdits, Claude Code mungkin dapat memodifikasi file konfigurasi IDE yang dapat dieksekusi secara otomatis oleh IDE Anda. Hal ini dapat meningkatkan risiko menjalankan Claude Code dalam mode acceptEdits dan memungkinkan dilewatinya permintaan izin Claude Code untuk eksekusi Bash.

Saat menjalankan di JetBrains IDE, pertimbangkan:

• Menggunakan mode Manual untuk pengeditan, karena acceptEdits dan auto mode sama-sama menyetujui pengeditan di dalam direktori kerja Anda tanpa bertanya, kecuali di jalur yang dilindungi
• Berhati-hati secara ekstra untuk memastikan Claude hanya digunakan dengan prompt tepercaya
• Mengetahui file mana saja yang dapat dimodifikasi oleh Claude Code

Untuk masalah instalasi atau login Claude Code di luar IDE, lihat Pemecahan masalah instalasi dan login.

Server MCP IDE bawaan

Ketika plugin aktif, plugin menjalankan server MCP lokal yang terhubung dengan CLI secara otomatis. Inilah cara CLI membuka diff di penampil diff bawaan IDE, membaca pilihan Anda saat ini untuk @-mention, dan memungkinkan Claude membaca diagnostik inspeksi.

Server ini bernama ide dan disembunyikan dari /mcp karena tidak ada yang perlu dikonfigurasi. Namun, jika organisasi Anda menggunakan hook PreToolUse untuk membuat allowlist tool MCP, Anda perlu mengetahui keberadaannya.

Konteks pilihan dan file yang terbuka. Saat terhubung, CLI menyertakan pilihan editor Anda saat ini dan jalur file aktif sebagai konteks pada setiap prompt yang Anda kirim. Transkrip menampilkan baris ⧉ Selected N lines from <file> ketika hal ini terjadi.

Jika Anda mengantrekan pesan saat Claude bekerja, pesan tersebut mempertahankan pilihan yang Anda miliki saat menekan Enter, apa pun yang Anda pilih setelahnya.

Untuk mengecualikan file sensitif seperti .env, tambahkan aturan deny Read untuk jalurnya. Aturan deny yang cocok mencegah teks yang dipilih maupun pemberitahuan file terbuka untuk file tersebut sampai ke Claude.

Transport dan autentikasi. Server mendengarkan pada port ephemeral yang ditetapkan oleh OS, dan port tersebut tidak dapat dikonfigurasi. Transport-nya adalah ws:// yang tidak terenkripsi; pada loopback, proses apa pun yang dapat menangkap lalu lintas juga dapat membaca token dari file lock, sehingga TLS tidak akan menambah perlindungan terhadap penyerang lokal. Setiap kali IDE dimulai, IDE menghasilkan token autentikasi acak yang baru, menuliskannya ke file lock di ~/.claude/ide/<port>.lock, dan CLI harus menyajikannya sebagai header X-Claude-Code-Ide-Authorization untuk terhubung. Jika CLAUDE_CONFIG_DIR diatur, file lock ditulis ke $CLAUDE_CONFIG_DIR/ide/ sebagai gantinya.

Tool yang diekspos ke model. Server menampung beberapa tool, tetapi hanya satu yang terlihat oleh model. Sisanya adalah RPC internal yang digunakan CLI untuk UI-nya sendiri, seperti membuka diff dan membaca pilihan, dan difilter sebelum daftar tool sampai ke Claude.

Plugin JetBrains tidak mengekspos tool eksekusi kode ke model.

Antarmuka yang didengarkan. Antarmuka jaringan yang diikat oleh server dikontrol oleh Accept connections from all network interfaces di bawah Settings → Tools → Claude Code [Beta] → Networking (Advanced). Dengan pengaturan ini dinonaktifkan, server hanya mendengarkan pada 127.0.0.1 dan tidak dapat dijangkau dari host lain. Dengan pengaturan ini diaktifkan, port dapat dijangkau dari jaringan lokal Anda. Pengaturan ini ada untuk kasus ketika CLI tidak dapat menjangkau IDE melalui loopback, seperti WSL2 dengan jaringan NAT default atau penyiapan IDE jarak jauh; lihat konfigurasi WSL untuk skenario tersebut.

[!WARNING]

Mengaktifkan Accept connections from all network interfaces membuat port MCP IDE dapat dijangkau dari jaringan lokal Anda. Koneksi tetap memerlukan token autentikasi dari file lock, tetapi karena transport-nya adalah ws:// yang tidak terenkripsi, baik lalu lintas sesi maupun token tersebut melintasi jaringan dalam bentuk teks biasa ketika pengaturan ini aktif. Aktifkan hanya ketika loopback tidak dapat berfungsi. Untuk WSL2, utamakan jaringan mirrored agar antarmuka loopback Windows dibagikan dengan VM Linux dan socket dapat tetap berada di loopback.