Claude Code w JetBrains (IntelliJ, PyCharm) - konfiguracja

Claude Code

Claude Code w JetBrains (IntelliJ, PyCharm) - konfiguracja

W skrócie

Claude Code, oficjalne narzędzie CLI od Anthropic do programowania z AI, integruje się z rodziną IDE od JetBrains - IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand i innymi. Dzięki dedykowanej wtyczce zmiany otwierają się w natywnym podglądzie różnic IDE, a Claude widzi Twoje zaznaczenie i diagnostykę z edytora. Konfiguracja jest prosta, ale ma jeden kluczowy szczegół, o który wielu się potyka: wtyczka to tylko nakładka, a właściwy silnik to CLI, które trzeba zainstalować osobno. Rozpiszmy to krok po kroku.

Jak to wygląda w praktyce

Instalujesz wtyczkę Claude Code w PyCharmie, klikasz jej ikonę i dostajesz komunikat w stylu "Cannot launch Claude Code" albo "command not found". Wygląda, jakby wtyczka była zepsuta, a tak naprawdę brakuje samego CLI na ścieżce systemowej. Inny częsty scenariusz: wtyczka działa, ale funkcje integracji (podgląd zmian w IDE, przekazywanie zaznaczenia) nie pojawiają się, bo uruchomiłeś Claude Code spoza właściwego katalogu albo IDE nie zostało zrestartowane po instalacji. Bywa też, że w terminalu JetBrains klawisz Escape nie przerywa agenta - to znany szczegół konfiguracji terminala.

Dlaczego Claude Code tak działa

Wtyczka JetBrains celowo nie dołącza własnej kopii Claude Code - zamiast tego uruchamia komendę claude we wbudowanym terminalu IDE i się z nią łączy. Dlatego potrzebne są dwa elementy naraz: zainstalowane CLI (żeby było co uruchomić) i wtyczka (żeby dołożyć integrację z edytorem). Gdy claude nie jest na ścieżce systemowej, wtyczka nie ma czego odpalić i pokazuje komunikat o niemożności uruchomienia. Sama integracja działa przez lokalny serwer, który wtyczka wystawia, a CLI się do niego podłącza - to właśnie tędy Claude otwiera zmiany w natywnym podglądzie IDE, czyta Twoje zaznaczenie do wzmianek plikowych i pobiera diagnostykę (błędy i ostrzeżenia z edytora). Escape w terminalu JetBrains bywa przechwytywany przez ustawienie IDE, stąd potrzeba drobnej korekty.

Jak to rozwiązać krok po kroku

1. Zainstaluj najpierw samo Claude Code (CLI) zgodnie z instrukcją startową Anthropic i upewnij się, że komenda claude działa w zwykłym terminalu - sprawdzisz to poleceniem claude --version.
2. Zainstaluj wtyczkę Claude Code z JetBrains Marketplace (Settings, sekcja Plugins) i zrestartuj IDE. Restart bywa konieczny, by wtyczka w pełni się aktywowała.
3. Otwórz wbudowany terminal IDE i uruchom w nim claude. Wszystkie funkcje integracji włączą się automatycznie, gdy startujesz z tego terminala. Przy pierwszym uruchomieniu przejdziesz logowanie - działa dowolna płatna subskrypcja Claude albo konto Claude Console, klucz API nie jest wymagany.
4. Uruchom Claude Code z katalogu będącego korzeniem projektu, żeby miał dostęp do tych samych plików co IDE. To warunek poprawnego działania podglądu zmian i kontekstu z edytora.
5. Jeśli claude jest zainstalowane w miejscu, którego IDE nie znajduje, wskaż pełną ścieżkę w ustawieniach wtyczki: Settings, Tools, Claude Code, pole komendy Claude.
6. Gdy Escape nie przerywa agenta w terminalu JetBrains, wejdź w Settings, Tools, Terminal i odznacz opcję przenoszenia fokusu do edytora klawiszem Escape (albo usuń skrót przełączania fokusu do edytora). Po zatwierdzeniu zmian Escape będzie normalnie przerywał pracę Claude Code.
7. Alternatywnie z zewnętrznego terminala możesz połączyć uruchomione IDE komendą /ide. Jeśli Claude Code wykryje działające IDE bez wtyczki, sam ją zainstaluje i poprosi o restart.

Jak sprawdzić, że zadziałało

Po uruchomieniu claude we wbudowanym terminalu poproś agenta o drobną edycję pliku - zmiana powinna otworzyć się w natywnym podglądzie różnic IDE, a nie tylko w terminalu. Zaznacz fragment kodu w edytorze: w stopce pola wpisywania Claude Code powinno pojawić się info o liczbie zaznaczonych linii, co potwierdza, że kontekst z edytora dochodzi. Jeśli łączyłeś się z zewnętrznego terminala komendą /ide, sukces potwierdza komunikat w stylu "Connected to IntelliJ IDEA". Na koniec sprawdź Escape w terminalu JetBrains - powinien teraz przerywać agenta, jeśli poprawiłeś ustawienie terminala.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5