Szybki start Claude Code: Od zera do produktywności w 2 godziny

Właśnie dołączyłeś do nowego zespołu. Baza kodu to 200 000 linii TypeScript rozłożonych na trzy serwisy, a twoje pierwsze zadanie jest do końca tygodnia. Mógłbyś spędzić dni na czytaniu dokumentacji i śledzeniu stosów wywołań — albo Claude Code może zmapować architekturę, przygotować plan implementacji i programować w parze z tobą jednego popołudnia.

Ten przewodnik przeprowadzi cię przez kompletną konfigurację, od pierwszej instalacji do dostarczenia prawdziwej funkcji, w około dwie godziny.

Co wyniesiesz z tego przewodnika

• W pełni zainstalowane i uwierzytelnione CLI Claude Code gotowe do codziennego użycia
• Dostrojony CLAUDE.md, który daje Claude głęboki kontekst twojego projektu
• Konfigurację uprawnień i modeli dopasowaną do twojego workflow
• Co najmniej jeden serwer MCP podłączony do dostępu do zewnętrznych narzędzi
• Twoja pierwsza gałąź funkcji zacommitowana i gotowa do przeglądu
• Strategie odzyskiwania na wypadek, gdy coś pójdzie nie tak

Plan na 2 godziny

Każdy krok linkuje do dedykowanego artykułu z głębszym omówieniem. Przepracuj je po kolei dla najlepszego doświadczenia.

1. Zainstaluj CLI (10 min) — Zainstaluj Claude Code na swojej maszynie pojedynczą komendą. Natywny instalator automatycznie aktualizuje się w tle. Przewodnik instalacji

2. Uwierzytelnij się (5 min) — Połącz się przez subskrypcję Claude Max, klucz API lub korporacyjne SSO. Jedna karta przeglądarki, jedno potwierdzenie, gotowe. Przewodnik uwierzytelniania

3. Skonfiguruj uprawnienia i modele (10 min) — Ustaw dozwolone narzędzia, reguły automatycznego zatwierdzania i wybierz domyślny model. Zdecyduj, ile autonomii dać Claude. Przewodnik konfiguracji

4. Skonfiguruj integrację z IDE (10 min) — Zainstaluj rozszerzenie VS Code lub wtyczkę JetBrains, aby Claude Code żył wewnątrz twojego edytora obok kodu. Przewodnik integracji IDE

5. Zainicjalizuj kontekst projektu (15 min) — Utwórz CLAUDE.md, który uczy Claude konwencji twojej bazy kodu, kluczowych poleceń i wzorców architektonicznych. Przewodnik inicjalizacji projektu

6. Planuj z workflow PRD (15 min) — Zamień wymagania produktowe w ustrukturyzowany plan i listę zadań wewnątrz Claude Code. Przewodnik workflow PRD

7. Użyj głębokiego rozumowania do trudnych problemów (10 min) — Naucz się kiedy i jak uruchamiać rozszerzone myślenie do decyzji architektonicznych i złożonego debugowania. Przewodnik głębokiego rozumowania

8. Podłącz serwery MCP (15 min) — Podłącz GitHub, Sentry, bazę danych lub dowolne zewnętrzne narzędzie przez Model Context Protocol. Przewodnik konfiguracji MCP

9. Zbuduj pierwszą funkcję (20 min) — Przejdź przez kompletny cykl implementacji z Claude Code jako swoim programistą w parze. Przewodnik workflow deweloperskiego

10. Zacommituj i zarządzaj gałęziami (10 min) — Użyj integracji git Claude Code do commitowania, tworzenia gałęzi i otwierania PR-ów z automatycznie generowanymi wiadomościami. Przewodnik kontroli wersji

11. Obsługuj awarie z wdziękiem (10 min) — Naucz się wzorców odzyskiwania, gdy Claude utknie, kontekst się zapełni lub edycje pójdą nie tak. Przewodnik odzyskiwania po błędach

Szybka checklista walidacji

Po zakończeniu pełnej konfiguracji przejdź tę checklistę, aby potwierdzić, że wszystko działa:

# 1. CLI is installed and on your PATH
claude --version

# 2. Authentication works
claude -p "say hello"

# 3. Your project has context
ls CLAUDE.md  # or .claude/CLAUDE.md

# 4. MCP servers are connected
claude mcp list

# 5. IDE extension is active
# Open VS Code, look for the Spark icon in the editor toolbar

Wskazówka

Gotowy do skopiowania prompt do weryfikacji pełnej konfiguracji:

Summarize my project structure, list the key technologies in use,
and confirm which MCP servers you can access. Then suggest one
improvement to my CLAUDE.md file.

Wybór ścieżki uwierzytelniania

Zanim zaczniesz, poznaj która ścieżka pasuje do twojej sytuacji:

Sytuacja	Metoda uwierzytelniania	Model kosztowy
Indywidualny deweloper szukający prostoty	Subskrypcja Claude Max	100-200$/mies. ryczałt
Eksploracja lub lekkie użycie	Konsola Anthropic (klucz API)	Płać za token
Zespół korporacyjny z potrzebami SSO	Claude for Teams/Enterprise	Wycena per stanowisko
Infrastruktura AWS	Amazon Bedrock	Rozliczenie chmurowe
Infrastruktura GCP	Google Vertex AI	Rozliczenie chmurowe
Infrastruktura Azure	Microsoft Foundry	Rozliczenie chmurowe

Subskrypcja Claude Max to najprostsza ścieżka dla indywidualnych deweloperów — nieograniczone użycie bez liczenia tokenów. Dostęp przez klucz API daje większą kontrolę rozliczeń, ale wymaga obserwowania kosztów. Plany korporacyjne dodają SSO, zarządzane polityki i scentralizowane rozliczenia.

Model mentalny: Terminal-first AI

Jeśli przechodzisz z Cursor lub innego agenta zintegrowanego z IDE, kluczowa zmiana w Claude Code polega na tym, że jest terminal-first. Twoja pętla workflow wygląda tak:

1. Opisujesz co chcesz w języku naturalnym w prompcie terminala
2. Claude czyta twoją bazę kodu, przeszukując pliki, sprawdzając typy, uruchamiając polecenia w razie potrzeby
3. Claude proponuje zmiany i prosi o zatwierdzenie przed zapisem plików
4. Przeglądasz, zatwierdzasz i iterujesz aż implementacja będzie poprawna
5. Claude commituje i tworzy PR-y gdy jesteś zadowolony

Ta pętla działa niezależnie od tego, czy jesteś w samodzielnym terminalu, wewnątrz zintegrowanego terminala VS Code, czy przez panel czatu rozszerzenia VS Code. Podstawowy silnik jest identyczny. Claude Code domyślnie używa Claude Opus 4.6 — najbardziej zdolnego modelu do agenckiego kodowania. Możesz przełączać na Claude Sonnet 4.5 przez komendę /model do szybszej iteracji na prostszych zadaniach.

Wskazówka

Gotowy do skopiowania prompt do eksploracji nowej bazy kodu:

Analyze this codebase and give me:
1. The main technologies and frameworks in use
2. The directory structure and what each top-level folder contains
3. How to run the dev server, tests, and linter
4. The 5 most important files I should read first

Referencja podstawowych poleceń

To polecenia, których będziesz używać każdego dnia. Dodaj tę tabelę do zakładek.

Polecenie	Co robi	Kiedy używać
claude	Rozpocznij sesję interaktywną	Na początku każdej sesji pracy
claude -c	Kontynuuj najnowszą rozmowę	Wznawianie po przerwie
claude -p "query"	Jednorazowe zapytanie, potem wyjście	Szybkie pytania bez pełnej sesji
claude commit	Wygeneruj wiadomość commita i zacommituj	Po zakończeniu zmiany
/compact	Skompresuj kontekst rozmowy	Gdy kontekst robi się duży
/clear	Zresetuj rozmowę całkowicie	Rozpoczynanie nowego zadania
/think	Włącz rozszerzone myślenie	Złożone decyzje architektoniczne
/model	Przełącz między modelami	Przełączanie między Opus 4.6 a Sonnet 4.5
/init	Zainicjalizuj plik CLAUDE.md	Pierwsza konfiguracja projektu
/cost	Pokaż zużycie tokenów dla sesji	Monitorowanie wydatków przy rozliczeniach kluczem API

Kiedy coś idzie nie tak

“Polecenie claude nie znalezione” — Twój PATH nie jest skonfigurowany. Natywny instalator (curl -fsSL https://claude.ai/install.sh | bash) obsługuje to automatycznie. Jeśli użyłeś Homebrew, uruchom brew link claude-code. Sprawdź za pomocą which claude.

“Uwierzytelnianie ciągle zawodzi” — Jeśli używasz subskrypcji Claude, upewnij się, że jesteś zalogowany na claude.ai w przeglądarce. Przepływ OAuth otwiera kartę przeglądarki. Jeśli używasz klucza API, sprawdź czy ANTHROPIC_API_KEY jest wyeksportowany w profilu shell (.zshrc lub .bashrc), nie tylko w bieżącej sesji.

“Claude nie rozumie mojego projektu” — Prawdopodobnie nie masz pliku CLAUDE.md. Uruchom /init wewnątrz sesji Claude Code, aby go zainicjalizować, a następnie dostosuj go swoimi poleceniami budowania, konwencjami kodowania i notatkami architektonicznymi.

“Okno kontekstu zapełnia się za szybko” — Użyj /compact, aby podsumować i skompresować rozmowę. Dla dużych baz kodu bądź konkretny, które katalogi analizować, zamiast prosić Claude o analizę wszystkiego naraz. Możesz też ustawić CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80, aby uruchamiać automatyczne kompaktowanie wcześniej.

“Claude zrobił złą edycję i chcę cofnąć” — Jeśli jesteś w rozszerzeniu VS Code, użyj funkcji cofania do punktu kontrolnego (najedź na dowolną wiadomość). W terminalu użyj git diff do przeglądu i git checkout -- <file> do cofnięcia. Claude nigdy nie pushuje bez twojego pozwolenia.

Co dalej

Zacznij od instalacji i przepracuj każdy przewodnik po kolei. Pierwsze trzy kroki — instalacja, uwierzytelnianie, konfiguracja — zajmują około 25 minut i dają ci działającą konfigurację Claude Code. Pozostałe kroki budują na tym fundamencie z dostosowaniem specyficznym dla projektu i prawdziwymi wzorcami workflow.

Instalacja Zainstaluj Claude Code na swojej maszynie w mniej niż 10 minut

Uwierzytelnianie Klucze API, subskrypcje i korporacyjne SSO

Konfiguracja Uprawnienia, modele i ustawienia automatycznego zatwierdzania

Integracja IDE Rozszerzenie VS Code i wtyczka JetBrains