Jak używać Claude Code z VS Code?
Claude Code to asystent AI firmy Anthropic zaprojektowany dla programistów. Dostępny bezpośrednio w VS Code poprzez oficjalne rozszerzenie, umożliwia generowanie, modyfikowanie, analizowanie i debugowanie kodu bez opuszczania edytora. Od 2025 roku natywne rozszerzenie jest zalecaną metodą używania Claude Code w VS Code — oto jak je zainstalować i jak najlepiej z niego korzystać.
Wymagania wstępne przed instalacją
Przed zainstalowaniem rozszerzenia Claude Code sprawdź następujące kwestie:
- VS Code 1.98.0 lub nowszy — starsze wersje nie są kompatybilne z rozszerzeniem
- Konto Anthropic — zalogujesz się przy pierwszym otwarciu rozszerzenia. Claude Code wymaga subskrypcji Claude Pro, Max, Team lub Enterprise
- Jeśli używasz Amazon Bedrock lub Google Vertex AI jako dostawcy, wymagana jest specyficzna konfiguracja w settings.json
Instalacja rozszerzenia Claude Code
Instalacja odbywa się bezpośrednio z VS Code w kilka sekund:
- Otwórz VS Code i naciśnij Ctrl+Shift+X (Windows/Linux) lub Cmd+Shift+X (Mac), aby otworzyć panel Rozszerzenia
- Wyszukaj "Claude Code" w pasku wyszukiwania
- Zainstaluj rozszerzenie opublikowane przez Anthropic — dokładnie sprawdź wydawcę, aby uniknąć nieoficjalnych rozszerzeń firm trzecich
- Jeśli ikona Spark nie pojawi się po instalacji, uruchom ponownie VS Code lub wykonaj "Developer: Reload Window" z palety poleceń
Warto wiedzieć: rozszerzenie automatycznie zawiera CLI (interfejs wiersza poleceń) Claude Code. Nie musisz instalować CLI osobno — jest ono dostępne bezpośrednio z wbudowanego terminala VS Code dla zaawansowanych funkcji.
Otwieranie Claude Code w VS Code
Po zainstalowaniu rozszerzenia ikona Spark (⚡) identyfikuje Claude Code w całym interfejsie VS Code. Kilka sposobów dostępu:
- Pasek narzędzi edytora: kliknij ikonę Spark w prawym górnym rogu edytora — widoczna tylko gdy plik jest otwarty
- Pasek aktywności: kliknij ikonę Spark na lewym pasku bocznym, aby otworzyć listę sesji. Zawsze widoczna nawet bez otwartego pliku
- Paleta poleceń: Cmd+Shift+P / Ctrl+Shift+P, wpisz "Claude Code" i wybierz "Open in New Tab"
- Pasek stanu: kliknij ✱ Claude Code w prawym dolnym rogu okna
Przy pierwszym otwarciu panelu pojawia się lista kontrolna z przewodnikiem wprowadzającym. Przejdź przez każdy krok klikając "Show me" lub zamknij ją krzyżykiem.
Wysyłanie pierwszego zapytania
Claude Code automatycznie widzi plik aktualnie otwarty w edytorze. Aby wchodzić w interakcję:
- Zaznacz kod w pliku — Claude Code automatycznie uwzględnia to zaznaczenie w kontekście zapytania
- Naciśnij Option+K (Mac) / Alt+K (Windows/Linux), aby wstawić odniesienie @plik.ts#5-10 do zaznaczenia w prompcie
- Wpisz zapytanie w języku naturalnym: "Wyjaśnij tę funkcję", "Napraw ten błąd", "Dodaj testy jednostkowe dla tej klasy"…
Gdy Claude Code proponuje modyfikację pliku, wyświetla porównanie diff obok siebie proponowanych zmian przed ich zastosowaniem. Możesz zaakceptować, odrzucić lub poprosić o korekty.
Tryby uprawnień
Claude Code oferuje trzy tryby uprawnień dostępne z dołu pola promptu:
| Tryb | Zachowanie | Zalecane użycie |
|---|---|---|
| Normalny | Claude pyta o potwierdzenie przed każdą akcją | Codzienne użycie, precyzyjna kontrola |
| Plan | Claude opisuje co zrobi i czeka na zatwierdzenie przed wprowadzeniem jakichkolwiek zmian | Złożone zadania, ważne refaktoryzacje |
| Auto-accept | Claude wprowadza zmiany bez pytania | Powtarzające się zadania, szybkie prototypowanie |
Tryb Plan jest szczególnie przydatny przy znaczących zmianach: Claude otwiera plan jako dokument Markdown, w którym możesz dodawać komentarze inline przed rozpoczęciem modyfikacji kodu.
Odwoływanie się do plików za pomocą @-wzmianek
Aby dostarczyć Claude Code dodatkowego kontekstu, używaj @-wzmianek w prompcie:
- Wpisz @ po którym następuje nazwa pliku, aby go wymienić: @auth.ts
- Dodaj zakres linii, aby celować w konkretną sekcję: @auth.ts#10-25
- Wymień cały folder: @src/components/
- Użyj Option+K / Alt+K z zaznaczenia, aby automatycznie wstawić odniesienie
Zarządzanie wieloma rozmowami
VS Code pozwala na jednoczesne otwieranie wielu sesji Claude Code — przydatne przy równoległej pracy nad wieloma funkcjami lub folderami workspace:
- Każda sesja utrzymuje własny niezależny kontekst
- Otwórz nową rozmowę za pomocą Cmd+N (Mac) / Ctrl+N (Windows/Linux) z panelu Claude
- Uzyskaj dostęp do historii rozmów z ikony Spark na pasku aktywności
- Sesje mogą być otwierane jako osobne karty lub okna zgodnie z preferencjami
Warto wiedzieć: jeśli pracujesz nad projektem monorepo lub mikroserwisami, każdy folder workspace może mieć własną sesję Claude Code z własnym kontekstem. Aby dostosować zachowanie Claude do projektu, utwórz plik CLAUDE.md w katalogu głównym repozytorium — Claude Code automatycznie go przeczyta, aby dostosować odpowiedzi do projektu, konwencji i konkretnych instrukcji.
Używanie CLI z wbudowanego terminala
Rozszerzenie VS Code zawiera CLI Claude Code, dostępne z wbudowanego terminala VS Code. CLI oferuje zaawansowane funkcje niedostępne w interfejsie graficznym:
- Uruchom claude w wbudowanym terminalu, aby rozpocząć sesję CLI
- Użyj claude -p "twój prompt" do nieinteraktywnych żądań (tryb print)
- Polecenie /terminal-setup w sesji automatycznie konfiguruje skrót Shift+Enter dla promptów wieloliniowych
- Przełączaj się między interfejsem graficznym a CLI przez menu ustawień rozszerzenia
Niezbędne skróty klawiaturowe
| Akcja | Mac | Windows / Linux |
|---|---|---|
| Otwórz panel Rozszerzenia | Cmd+Shift+X | Ctrl+Shift+X |
| Paleta poleceń | Cmd+Shift+P | Ctrl+Shift+P |
| Wstaw @-wzmiankę z zaznaczenia | Option+K | Alt+K |
| Przełącz fokus edytor / Claude | Cmd+Esc | Ctrl+Esc |
| Nowa rozmowa | Cmd+N | Ctrl+N |
Warto wiedzieć: Claude Code dla VS Code działa również z Cursor, Windsurf i VSCodium — procedura instalacji jest identyczna. Dla zespołów korzystających z Amazon Bedrock lub Google Vertex AI, dodaj odpowiednie zmienne środowiskowe w pliku settings.json VS Code, aby skonfigurować alternatywnego dostawcę.
Nicolas,