Integracja Claude Code z IDE: VS Code, JetBrains i dowolny edytor

Claude Code łączy się z edytorami na trzy sposoby: przez rozszerzenie VS Code z graficznym panelem czatu (instalowane także w Cursorze i innych forkach VS Code), przez wtyczkę JetBrains uruchamiającą CLI claude w terminalu IDE oraz przez CLI w terminalu dowolnego edytora. Połączona sesja widzi zaznaczenie, pokazuje zmiany w widoku diff IDE i czyta diagnostykę IDE.

Ta strona jest dla programistów, którzy mają już działający Claude Code w terminalu i chcą go mieć w edytorze. Typowy problem: kopiujesz ścieżki plików do terminala, przełączasz okna, żeby przeczytać diff, a błąd typów, który wprowadził Claude, zauważasz dopiero po dziesięciu minutach, gdy otwierasz plik. Połączone IDE rozwiązuje wszystkie trzy problemy, o ile ustawisz właściwy tryb uprawnień i nawyk weryfikacji.

Co zyskasz dzięki integracji Claude Code z IDE

• Zainstalowane i zalogowane rozszerzenie VS Code lub wtyczkę JetBrains, potwierdzone poleceniem /status.
• Świadomy wybór startowego trybu uprawnień, łącznie z jedynym ustawieniem, którego rozszerzenie nie czyta z plików projektu.
• Trzy prompty do skopiowania: analiza zaznaczenia, naprawa polecenia, które padło w terminalu, i przebieg weryfikacji korzystający z diagnostyki samego IDE.
• Sposób naprawy ośmiu awarii, które najczęściej zdarzają się w pierwszym tygodniu.

Wszystko poniżej sprawdzono 26 września 2026 r. na Claude Code 2.1.283 (claude --help) i w oficjalnych przewodnikach dla VS Code oraz JetBrains, z wyjątkiem fragmentów z datą 2026-10-12, które sprawdzono ponownie tego dnia na Claude Code 2.1.296 i na stronach Anthropic.

Którą integrację Claude Code z IDE wybrać?

Wybieraj najpierw według edytora, potem według tego, ile funkcji CLI potrzebujesz.

Twój edytor	Użyj	Co dostajesz	Z czego rezygnujesz
VS Code, Cursor lub inny fork VS Code	Rozszerzenie VS Code	Panel czatu, diffy inline z akceptacją pojedynczych zmian, przegląd planu jako dokument Markdown, historia sesji, punkty kontrolne w interfejsie	Część poleceń slash, skrót ! do Basha i uzupełnianie tabulatorem (po nie uruchom CLI w terminalu)
IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Android Studio	Wtyczka JetBrains	Pełne CLI w terminalu IDE, widok diff IDE, udostępnianie zaznaczenia, diagnostyka	Brak graficznego panelu czatu: wtyczka uruchamia claude w terminalu
Neovim, Emacs, Sublime Text, Zed i każdy inny	CLI w terminalu edytora	Wszystkie funkcje CLI	Brak widoku diff IDE, udostępniania zaznaczenia i narzędzia diagnostyki; edytor przeładowuje pliki z dysku

Jeśli zamiast panelu w edytorze wolisz osobne okno, alternatywą jest aplikacja desktopowa Claude Code. Dalsza część strony opisuje trzy ścieżki edytorowe.

Zainstaluj rozszerzenie Claude Code dla VS Code

Potrzebujesz VS Code 1.94.0 lub nowszego oraz płatnego planu Claude (Pro, Max, Team lub Enterprise) albo konta Claude Console. Jeśli firma korzysta z Claude przez Amazon Bedrock, Agent Platform w Google Cloud lub Microsoft Foundry, najpierw dokończ uwierzytelnianie, bo rozszerzenie czyta ten sam plik ~/.claude/settings.json.

1. Zainstaluj rozszerzenie. W VS Code naciśnij Cmd+Shift+X (macOS) lub Ctrl+Shift+X (Windows i Linux), wyszukaj Claude Code od Anthropic i kliknij Install. W Cursorze wyszukaj je tak samo w widoku Extensions. Inne forki VS Code mogą je zainstalować z rejestru Open VSX.

2. Otwórz plik, a potem kliknij ikonę Spark na pasku narzędzi edytora (prawy górny róg). Ikona pojawia się tylko przy otwartym pliku. Ikona Spark na pasku aktywności po lewej otwiera listę sesji i jest widoczna zawsze.

3. Kliknij Sign in i dokończ autoryzację w przeglądarce. Jeśli korzystasz z ANTHROPIC_API_KEY ustawionego w powłoce, a mimo to widzisz ekran logowania, VS Code nie odziedziczył środowiska: zamknij go i uruchom z terminala poleceniem code ..

4. Wpisz /status w polu promptu. Zobaczysz wersję Claude Code, konto, model i serwery MCP sesji. Zanim poprosisz o jakąkolwiek zmianę, upewnij się, że konto i model są tymi, których się spodziewasz. Wpisanie /status w panelu wymaga v2.1.280+; w starszych wersjach uruchom claude w zintegrowanym terminalu i użyj /status tam.

5. Jeśli jeszcze tego nie zrobiłeś, zainstaluj też samodzielne CLI według przewodnika instalacji. Rozszerzenie zawiera prywatną kopię CLI dla swojego panelu, ale nie dodaje claude do PATH, więc bez osobnej instalacji claude w zintegrowanym terminalu nie zadziała.

Rozszerzenie i CLI współdzielą ~/.claude/settings.json, serwery MCP, pluginy i historię rozmów. Uruchom claude --resume w terminalu, żeby kontynuować rozmowę zaczętą w panelu.

Wybierz tryb uprawnień, w którym startuje rozszerzenie

Wskaźnik trybu na dole pola promptu pokazuje, ile Claude robi bez pytania. Od v2.1.283 (oba kanały wydań na 2026-10-12) nowe rozmowy w VS Code startują w trybie Auto na każdym planie i u każdego dostawcy, a klasyfikator ocenia akcje zamiast pytać ciebie; we wcześniejszych wersjach dotyczy to tylko planów Pro, Max i Team. Model, którego tryb Auto nie obsługuje (np. domyślny Sonnet 4.5 w Microsoft Foundry), sprawia, że rozmowa startuje w Manual. Pozostałe tryby to Manual (wartość w konfiguracji default: Claude pyta przed edycjami i większością poleceń powłoki), Plan (Claude proponuje plan i czeka; VS Code otwiera go jako dokument Markdown, który możesz komentować) oraz Edit automatically (acceptEdits).

W pierwszym tygodniu pracy z repozytorium wybieraj Manual lub Plan. Manual pokazuje każdą edycję jako diff obok siebie, z przyciskami Accept this change i Reject this change przy każdym fragmencie (v2.1.275+), więc zanim oddasz agentowi więcej, widzisz, co robi. Diff z ponad 100 zmianami otwiera się bez tych przycisków; potraktuj to jako sygnał, że krok był za duży, i poproś o mniejszy. Żeby ustalić tryb startowy, ustaw go w ustawieniach użytkownika VS Code (nie w ustawieniach obszaru roboczego):

VS Code user settings.json

{
  "claudeCode.initialPermissionMode": "plan"
}

Rozszerzenie startuje każdą nową rozmowę w pierwszym trybie z tej listy, który ma zastosowanie:

1. claudeCode.initialPermissionMode z ustawień użytkownika VS Code (wartości obszaru roboczego są ignorowane).
2. Tryb ostatnio wybrany we wskaźniku, jeśli był to Manual, Edit automatically lub Auto. Wybór Plan dotyczy tylko bieżącej rozmowy.
3. permissions.defaultMode z ustawień zarządzanych (managed settings) lub ~/.claude/settings.json.
4. Wbudowana wartość domyślna (Auto od v2.1.283).

Z tego wynikają dwie rzeczy, które regularnie zaskakują. Ustawienie nie przyjmuje wartości auto: żeby startować w Auto, zostaw je nieustawione i raz wybierz Auto we wskaźniku. Poza tym rozszerzenie nigdy nie czyta trybu startowego z .claude/settings.json projektu, więc zespołowa wartość zapisana w tym pliku działa tylko w sesjach terminalowych; zespół, który potrzebuje jednego trybu wszędzie, ustawia go w ustawieniach zarządzanych. Ustawienia sesji terminalowych i reguły uprawnień opisuje przewodnik po konfiguracji.

Automatycznie akceptowane edycje mogą sięgnąć konfiguracji IDE, która uruchamia kod

W trybach Auto i Edit automatically Claude może zmieniać pliki takie jak .vscode/settings.json, .vscode/tasks.json czy konfiguracje uruchomieniowe JetBrains, które IDE może wykonać. Repozytorium, któremu nie ufasz, otwieraj najpierw w VS Code w trybie ograniczonym (Restricted Mode; rozszerzenie w nim nie działa, więc przejrzyj repozytorium, zanim zaufasz obszarowi roboczemu), potem zostań w Manual i nie włączaj claudeCode.allowDangerouslySkipPermissions, które dodaje do menu Bypass permissions i nadaje się wyłącznie do jednorazowego sandboksa bez dostępu do sieci. Pełny model opisuje strona Uprawnienia i sandboxing.

Przekaż Claude kontekst z edytora

Połączony edytor wysyła kontekst, który inaczej wklejałbyś ręcznie.

• Zaznaczenie. Claude automatycznie widzi zaznaczony kod; stopka pola promptu pokazuje liczbę linii. Naciśnij Option+K (macOS) lub Alt+K (Windows i Linux), żeby wstawić jawne odwołanie, np. @app.ts#5-10.
• Otwarty plik. Nazwa aktywnego pliku jest dołączana do każdej wiadomości. Wyłącz claudeCode.attachOpenFile, żeby wysyłać tylko zaznaczenie.
• Pliki i foldery. Wpisz @ i fragment nazwy; dopasowanie jest rozmyte, więc @auth znajdzie AuthService.ts. Folder zakończ znakiem / (@src/components/).
• Wyjście terminala. @terminal:NAZWA dołącza wyjście zintegrowanego terminala o tytule NAZWA, więc Claude czyta stack trace bez kopiowania.

Prompt do skopiowania: przegląd zaznaczenia przed zmianą

Look at the code I have selected. Explain what it does in three sentences,
then list every input that would make it throw or return a wrong value,
with the line number for each. Do not edit anything yet. End with the one
test you would write first to pin the current behaviour.

Prompt do skopiowania: naprawa polecenia, które padło w terminalu

@terminal:zsh The last command in that terminal failed. Find the root cause,
not the first symptom. Propose the smallest fix, show me the diff, and name
the command I should rerun to prove it works. If the fix touches more than
two files, stop and use plan mode first.

Zamień zsh na tytuł swojej karty terminala (np. bash albo npm).

Panel nie wysyła zaznaczonego tekstu z plików pasujących do files.exclude, search.exclude lub .gitignore (przy domyślnym claudeCode.respectGitIgnore), najwyżej samą ścieżkę. CLI w zintegrowanym terminalu i wtyczka JetBrains tego filtra nie stosują. Żeby plik taki jak .env nie trafiał do Claude z żadnej powierzchni, dodaj dla niego regułę deny Read w .claude/settings.json; pasująca reguła blokuje zarówno zaznaczenie, jak i informację o otwartym pliku.

Jak sprawdzić zmiany agenta bez czytania każdej linii?

Połączenie z IDE daje Claude narzędzie, którego brakuje w zwykłym terminalu: mcp__ide__getDiagnostics, zwracające błędy i ostrzeżenia z serwera języka w edytorze (panel Problems w VS Code, inspekcje w JetBrains). W JetBrains każde wywołanie obejmuje jeden plik; w VS Code wywołanie może objąć jeden plik albo cały panel Problems. Claude nie wywołuje go niezawodnie po edycjach, więc musisz o to poprosić. W połączeniu z poleceniami testów i sprawdzania typów dostajesz przebieg weryfikacji, którego wynik ocenisz w kilka sekund.

Prompt do skopiowania: weryfikacja przed akceptacją

Before I accept these changes, verify them:
1. Call the IDE diagnostics tool for each file you changed and fix
   any error or warning you introduced.
2. Run the project's type check, linter, and the tests that cover the
   changed files. Use the commands in CLAUDE.md or package.json.
3. Report a table: file, diagnostics before and after, tests run, result.
Do not mark anything as done if a command failed or was skipped. Say which.

Potem sprawdzasz dowody, a nie kod: panel Problems jest pusty dla zmienionych plików, polecenie testów z raportu faktycznie się wykonało (możesz je powtórzyć w terminalu), a diff dotyka tylko plików, których się spodziewałeś. W trybie Manual to ty akceptujesz diff; w zespole ostatnie słowo należy do bramki CI. Strona Chroń wyrocznię testów pokazuje, jak nie dopuścić, żeby agent „naprawił” błąd, edytując test.

Gdy zmiana idzie w złą stronę, cofnij ją zamiast poprawiać ręcznie. W panelu najedź na wiadomość i wybierz Rewind code to here, Fork conversation from here albo Fork conversation and rewind code. W CLI uruchom /rewind lub naciśnij dwa razy Esc przy pustym polu promptu. Punkty kontrolne śledzą wyłącznie narzędzia edycji plików Claude: zmiany z poleceń Basha, z subagentów (poza skillem typu fork działającym na pierwszym planie) lub twoje własne poza Claude nie zostaną przywrócone, więc przed dużym zadaniem zrób commit i do tych przypadków używaj gita.

Skonfiguruj wtyczkę JetBrains

Wtyczka JetBrains nie zawiera CLI. Uruchamia claude w terminalu IDE i łączy się z nim.

1. Zainstaluj CLI według przewodnika instalacji i uruchom claude --version, żeby potwierdzić, że jest w PATH.

2. W IDE otwórz Settings → Plugins → Marketplace, zainstaluj Claude Code [Beta] od Anthropic i zrestartuj IDE.

3. Otwórz terminal IDE w katalogu głównym projektu i uruchom claude albo naciśnij Cmd+Esc (macOS) lub Ctrl+Esc (Windows i Linux). Przy pierwszym uruchomieniu zaloguj się. Z zewnętrznego terminala uruchom zamiast tego /ide w sesji; potwierdzi połączenie komunikatem w rodzaju Connected to IntelliJ IDEA., a jeśli działające IDE nie ma wtyczki, zainstaluje ją i poprosi o restart IDE.

4. Uruchom /config i ustaw Diff tool na auto, żeby edycje otwierały się w widoku diff IDE. Ta opcja pojawia się tylko, gdy IDE jest połączone.

5. Zaznacz kilka linii i wyślij prompt. Gdy zaznaczenie dotrze do Claude, w transkrypcie pojawi się ⧉ Selected N lines from <file>. Odwołanie do pliku wstawisz skrótem Cmd+Option+K (macOS) lub Alt+Ctrl+K (Windows i Linux).

Jeśli wtyczka pokazuje „Cannot launch Claude Code”, bo claude leży w miejscu, którego IDE nie widzi, podaj pełną ścieżkę w Settings → Tools → Claude Code [Beta] → Claude command. W WSL użyj wsl -d Ubuntu -- bash -lic "claude" z nazwą swojej dystrybucji. Przy JetBrains Remote Development zainstaluj wtyczkę na zdalnym hoście (Settings → Plugin (Host)), a nie na laptopie.

Używaj Claude Code w terminalu dowolnego innego edytora

Terminal VS Code lub Cursora

Otwórz zintegrowany terminal (Ctrl+` lub Cmd+`) i uruchom:

claude

W terminalu VS Code CLI łączy się z IDE automatycznie, z widokiem diff i diagnostyką. Z zewnętrznego terminala uruchom /ide w sesji albo startuj przez claude --ide, żeby połączyć się od razu, gdy dostępne jest dokładnie jedno IDE.

Neovim, Emacs i inne

Uruchom claude w podziale terminala edytora, w katalogu głównym projektu:

claude

Claude zapisuje na dysk, a edytor przeładowuje bufory. Nie ma połączenia z IDE, więc zamiast o diagnostykę proś Claude o uruchomienie kompilatora lub lintera. Układy podzielonego ekranu i hooki automatycznego przeładowania opisuje strona Koordynacja IDE i CLI.

Rozszerzenie czy CLI: które funkcje się różnią?

Funkcja	Rozszerzenie VS Code	CLI (dowolny terminal, wtyczka JetBrains)
Polecenia i skills	Podzbiór (wpisz /, żeby zobaczyć)	Wszystkie
Zarządzanie serwerami MCP	Tak, okno /mcp	Tak, /mcp i claude mcp add
Punkty kontrolne i cofanie	Tak, menu po najechaniu	Tak, /rewind lub Esc Esc
Zarządzanie pluginami	Tak, okno /plugins (/plugin otwiera to samo)	Tak, /plugin albo claude plugin
Skrót ! do Basha, uzupełnianie tabulatorem	Nie	Tak
Równoległe rozmowy	Karty i okna (Cmd+Shift+Esc / Ctrl+Shift+Esc)	Osobne terminale lub worktree

Panelu używaj do codziennych edycji, które chcesz przejrzeć wizualnie. Po polecenie dostępne tylko w CLI przejdź do claude w zintegrowanym terminalu; historia rozmów jest wspólna, więc nic nie tracisz.

Skróty i ustawienia VS Code, które warto zmienić

Skrót (macOS / Windows i Linux)	Działanie
Cmd+Esc / Ctrl+Esc	Przełącza fokus między edytorem a Claude
Cmd+Shift+Esc / Ctrl+Shift+Esc	Nowa rozmowa w karcie edytora
Option+K / Alt+K	Wstawia @-odwołanie do bieżącego zaznaczenia
Ctrl+Option+F / Ctrl+Alt+F	Włącza i wyłącza Focus view (ukrywa wywołania narzędzi)
Shift+Enter	Nowa linia bez wysyłania

Ustawienia znajdziesz w Extensions → Claude Code (claudeCode.* w settings.json):

Ustawienie	Domyślnie	Zmień, gdy
initialPermissionMode	nieustawione	Każda nowa rozmowa ma startować w Manual lub Plan
preferredLocation	panel	Chcesz mieć Claude w prawym pasku bocznym (sidebar)
useTerminal	false	Wolisz interfejs CLI wewnątrz rozszerzenia
autosave	true	Rzadko: zapisuje pliki, zanim Claude je przeczyta lub zapisze
useCtrlEnterToSend	false	Ciągle wysyłasz niedokończone prompty klawiszem Enter
enableNewConversationShortcut	false	Chcesz nową rozmowę pod Cmd+N / Ctrl+N

Rozszerzenie potrafi też sterować Chrome’em przy testowaniu aplikacji webowych przez @browser (np. @browser go to localhost:3000 and check the console for errors), gdy zainstalujesz rozszerzenie Claude in Chrome w wersji 1.0.36 lub nowszej. Chrome włączasz sam przez /chrome albo claude --chrome: od v2.1.290 (oba kanały wydań na 2026-10-17) plik .claude/settings.json projektu nie może go włączyć, bo pobrane repozytorium nie może podłączać Claude do twojej przeglądarki (dokumentacja Claude in Chrome, sprawdzona 2026-10-12).

Kiedy integracja Claude Code z IDE się psuje

Brak ikony Spark w VS Code. Otwórz plik (sam folder nie wystarczy), sprawdź w Help → About, czy masz 1.94.0 lub nowszy, i uruchom Developer: Reload Window. Rozszerzenie nie działa w Restricted Mode. Wyłącz inne rozszerzenia AI, np. Cline lub Continue, żeby wykluczyć konflikt.

claude: command not found w terminalu VS Code. CLI dołączone do rozszerzenia jest prywatne. Zainstaluj samodzielne CLI i otwórz nowy terminal.

Cmd+Esc nic nie robi na macOS. Od macOS Tahoe skrót przechwytuje systemowa nakładka Game Overlay. Wyłącz ją w System Settings → Keyboard → Keyboard Shortcuts → Game Controllers albo przypisz inny skrót do Claude Code: Focus input w VS Code.

/ide zgłasza „No available IDEs detected”. Sprawdź, czy wtyczka lub rozszerzenie są włączone, zrestartuj IDE całkowicie i uruchamiaj claude z katalogu głównego projektu. W WSL2 połączenie zwykle blokuje sieć NAT lub Zapora Windows: przepuść podsieć WSL2 przez zaporę albo ustaw networkingMode=mirrored w .wslconfig (Windows 11 22H2 lub nowszy) i uruchom wsl --shutdown.

Esc nie przerywa Claude w terminalu JetBrains. W Settings → Tools → Terminal odznacz Move focus to the editor with Escape.

Rozmowa startuje w Manual, choć spodziewałeś się Auto. Auto wymaga obsługiwanego modelu i braku disableAutoMode w plikach ustawień; konfiguracja z claudeCode.claudeProcessWrapper również startuje w Manual, podobnie jak rozmowa, do której przeszedł wybór Manual z wcześniejszej rozmowy, lub gdy ~/.claude/settings.json ustawia permissions.defaultMode. Uruchom /status, żeby zobaczyć model, a potem wybierz Auto we wskaźniku.

Po cofnięciu pliki nadal są zmienione. Zmiany pochodziły z polecenia Basha, subagenta (poza skillem typu fork działającym na pierwszym planie) lub edycji spoza Claude, a tych punkty kontrolne nie śledzą. Uruchom git status, przywróć pliki przez git restore i poproś Claude, żeby powtórzył krok przez swoje narzędzia edycji.

Claude w panelu w ogóle nie odpowiada. Zacznij nową rozmowę, a potem uruchom claude w terminalu: CLI wypisze szczegółowy błąd (zwykle uwierzytelnianie lub sieć). Pozostałe przypadki opisuje przewodnik po odzyskiwaniu po błędach.

Dokąd dalej po integracji z IDE

Inicjalizacja projektu Napisz CLAUDE.md, który da każdej sesji w IDE polecenia budowania i testów.

Koordynacja IDE i CLI Układy podzielonego ekranu, hooki przeładowania i wybór powierzchni.

Konfiguracja MCP Podłącz GitHuba, bazy danych i przeglądarki raz dla rozszerzenia i CLI.

Konfiguracja Reguły uprawnień i pliki ustawień wspólne dla IDE i terminala.

Pracujesz z Codexem albo Cursorem? Zajrzyj do konfiguracji Codexa, gdzie opisano rozszerzenie IDE i CLI Codexa, albo do konfiguracji Cursora, gdzie opisano wbudowanego agenta Cursora.