Jak zacząć kodować z Claude Code w terminalu - przewodnik

Żeby zacząć z Claude Code w terminalu, potrzebujesz trzech rzeczy: płatnego planu Claude (Pro, Max, Team albo Enterprise) lub konta Claude Console, jednego polecenia instalacji i pustego folderu na pierwszą próbę. Darmowy plan Claude nie obejmuje Claude Code. Na macOS, Linuksie i w WSL instalujesz go poleceniem curl -fsSL https://claude.ai/install.sh | bash, w Windows PowerShell poleceniem irm https://claude.ai/install.ps1 | iex. Potem otwierasz nowe okno terminala, wpisujesz claude i logujesz się w przeglądarce. Instalator natywny nie wymaga wcześniejszej instalacji Node.js.

Instalacja według systemu

Czarne okno z migającym kursorem potrafi onieśmielić. Na tym etapie wklejasz jedną linijkę i czekasz, nic więcej. Terminal otworzysz tak: na macOS Cmd + Spacja, wpisz Terminal i naciśnij Enter. W Ubuntu zadziała Ctrl + Alt + T. W Windows naciśnij Win + X i wybierz Windows PowerShell albo Terminal.

Polecenia poniżej pochodzą z oficjalnej instrukcji instalacji Claude Code, odczytanej 17 października 2026. W Windows rozpoznasz PowerShell po początku wiersza PS C:\. CMD pokazuje samo C:\, bez PS.

Instalator nie pokazuje postępu pobierania. Nie zamykaj okna, to nie zawieszenie. Na końcu zobaczysz komunikat, że instalacja się powiodła. Wersja natywna aktualizuje się sama w tle. W Windows nie musisz uruchamiać instalatora jako administrator. To polecenie pobiera i uruchamia program z claude.ai, więc używaj go na komputerze, na którym masz prawo instalować oprogramowanie.

Wymagania i inne metody

Według dokumentacji Claude Code działa na macOS 13.0 lub nowszym, Windows 10 w wersji 1809 lub nowszej, Windows Server 2019+, Ubuntu 20.04+, Debianie 10+ i Alpine Linux 3.19+. Potrzebujesz co najmniej 4 GB RAM, procesora x64 lub ARM64 i internetu. Polska jest na liście krajów obsługiwanych przez Anthropic.

Starsze poradniki pokazują instalację przez npm. Ta droga nadal działa (npm install -g @anthropic-ai/claude-code), ale wymaga Node.js 22 lub nowszego, a dokumentacja odradza uruchamianie jej przez sudo. Na start wybierz instalator natywny. Wolisz okno z przyciskami zamiast terminala? Claude Code działa też w aplikacji desktopowej, w rozszerzeniu do VS Code i w przeglądarce pod claude.ai/code.

Konto i sposób płatności

Najtańszy abonament z Claude Code to Pro. Według cennika, stan na 17 października 2026, Pro kosztuje 20 USD miesięcznie albo 17 USD miesięcznie przy płatności rocznej (200 USD z góry). Max 5x to 100 USD, a Max 20x 200 USD miesięcznie. To ceny bez podatku. Przy zakupie z Polski Pro kosztuje 18 EUR miesięcznie bez VAT, czyli 78,59 zł netto i 96,67 zł z 23% VAT po kursie NBP z 16.10.2026.

W Pro i Max limity są wspólne. Praca w terminalu i rozmowy w czacie zjadają tę samą pulę. Limit sesji odnawia się co pięć godzin, a do tego dochodzi limit tygodniowy.

Konto Claude Console to dostęp przez API z kredytami opłacanymi z góry. Przy pierwszym logowaniu w Console powstaje automatycznie obszar roboczy „Claude Code”, w którym śledzisz koszty. Abonament i rozliczenie przez API porównuje tekst ile kosztuje Claude dla programistów.

Jedna pułapka na start: zmienna ANTHROPIC_API_KEY. Jeśli jest ustawiona, Claude Code zapyta, czy użyć tego klucza. Zgoda oznacza rozliczenie z konta API po stawkach za zużycie, nawet gdy płacisz za Pro. Żeby korzystać z abonamentu, nie ustawiaj tej zmiennej. Sprawdzisz ją w zwykłym terminalu: echo $ANTHROPIC_API_KEY na macOS i Linuksie, echo $env:ANTHROPIC_API_KEY w PowerShell. Jeśli coś się wyświetli, nie wklejaj tej wartości do rozmowy, zrzutu ani zgłoszenia. Zachowanie opisuje pomoc dotycząca zmiennych API.

Pierwsza sesja: logowanie i podstawowe polecenia

Wejdź do folderu projektu i wpisz claude. Przy pierwszym uruchomieniu otworzy się przeglądarka z logowaniem. Jeśli się nie otworzy, naciśnij c: adres logowania trafi do schowka i wkleisz go ręcznie. Dane logowania zostają zapisane, więc nie logujesz się przy każdym starcie. Nad polem do pisania zobaczysz wersję, aktywny model i katalog roboczy.

Teraz rzecz ważniejsza od samych poleceń: tryb uprawnień. Od wersji 2.1.283 sesja w terminalu startuje domyślnie w trybie auto. Claude działa wtedy bez pytania o każdą zmianę, a jego akcje sprawdza osobny model, tak zwany klasyfikator. Dokumentacja pisze wprost, że tryb auto zmniejsza liczbę pytań, ale nie gwarantuje bezpieczeństwa. Pierwsza sesja w trybie auto to jak oddanie kluczyków do auta komuś, kogo znasz od pięciu minut.

Na start uruchom claude --permission-mode manual. W trybie Manual Claude pyta przed większością edycji plików, poleceń w powłoce i połączeń z siecią. Ten sam efekt da jedno naciśnięcie Shift+Tab w trybie auto. Na pasku stanu pojawi się wtedy manual mode on. Szczegóły są w opisie trybów uprawnień.

Plik CLAUDE.md i polecenie /init

/init ma sens w folderze, w którym jest już kod. Claude przegląda projekt i zapisuje w CLAUDE.md polecenia budowania, testów i konwencje, które znalazł. Jeśli plik już istnieje, /init proponuje poprawki zamiast go nadpisywać. CLAUDE.md to zwykły plik tekstowy, który Claude czyta na początku każdej sesji. Dopisuj tam to, co inaczej tłumaczysz za każdym razem od nowa, np. „Odpowiadaj po polsku” albo „Nie instaluj nowych pakietów bez pytania”. Claude traktuje ten plik jako wskazówki, nie jako twardą blokadę.

Pierwsze zadanie w oddzielnym folderze

mkdir claude-demo
cd claude-demo
git init
claude --permission-mode manual

git init wymaga zainstalowanego Gita. Dzięki niemu zobaczysz każdą zmianę, jaką Claude wprowadzi w folderze. Wpisz polecenie:

Stwórz plik hello.js z funkcją sum(a, b), która zwraca a + b.
Na końcu pliku dodaj dokładnie: module.exports = { sum };
Nie instaluj zależności i nie zmieniaj plików poza tym folderem.

Gdy Claude zapyta o zgodę na utworzenie pliku, przeczytaj, co chce zapisać, i dopiero wtedy wybierz Yes. Po zakończeniu wyjdź z sesji albo otwórz drugie okno terminala w tym samym folderze. git status pokaże hello.js jako nowy, nieśledzony plik. git diff przy nowym pliku nic nie pokaże, bo porównuje tylko pliki, które Git już śledzi. Przyda się przy kolejnych zmianach, po pierwszym commicie.

Do uruchomienia przykładu potrzebujesz Node.js. Sprawdzenie wygląda tak:

node -e "const {sum}=require('./hello.js'); if(sum(2,3)!==5) process.exit(1); console.log('5');"

W naszej próbie z 2 października 2026 natywny Claude Code 2.1.286 na Linuksie odpowiedział komunikatem o tygodniowym limicie konta, więc hello.js nie powstał, a CLI naliczyło 0 USD (zapis naszej próby i komunikatu o limicie). Swój wynik sprawdzisz poleceniem testowym powyżej: ma wypisać 5.

Gdy hello.js działa, daj Claude własne małe zadanie. Zacznij wiadomość od /plan. Claude przejrzy pliki i przygotuje plan, ale nie zmieni kodu, dopóki planu nie zatwierdzisz. Wklej szablon w całości i uzupełnij pola w nawiasach:

/plan Pracujemy tylko w folderze [nazwa folderu].
Zadanie: [co ma powstać, np. skrypt, który zmienia nazwy zdjęć .jpg na datę z nazwy pliku].
Dane wejściowe: [jakie pliki albo przykładowe dane ma wykorzystać].
Ograniczenia: nie instaluj zależności, nie usuwaj plików, nie zmieniaj niczego poza tym folderem.
Na koniec podaj jedno polecenie, którym sprawdzę wynik.

Pisząc z ręki, nową linię dodasz kombinacją Shift+Enter albo Ctrl+J, która działa w każdym terminalu.

Gdy plan będzie gotowy, Claude zapyta, co dalej. Opcja Yes, and use auto mode przełącza sesję w tryb auto. Jeśli chcesz dalej zatwierdzać każdą zmianę, wybierz Yes, manually approve edits.

Gdy coś nie działa

• command not found: claude albo 'claude' is not recognized: otwórz nowe okno terminala i spróbuj ponownie. Jeśli dalej nic, katalog instalacji nie trafił do zmiennej PATH. Poprawkę dla każdego systemu opisuje strona o problemach z instalacją.
• The token '&&' is not a valid statement separator: jesteś w PowerShell, a wkleiłeś polecenie dla CMD. Komunikat 'irm' is not recognized oznacza odwrotną sytuację.
• Nie masz pomysłu, co nie gra: wpisz claude doctor. Polecenie wypisuje diagnostykę instalacji i ustawień bez uruchamiania sesji.
• Logowanie się sypie: wpisz /logout, zamknij Claude Code, uruchom claude i zaloguj się od nowa. Przy błędzie 403 po zalogowaniu sprawdź w claude.ai/settings, czy subskrypcja jest aktywna.
• You've hit your weekly limit albo You've hit your session limit: Claude Code wstrzymuje zapytania do godziny podanej w komunikacie, a zmiana modelu tego nie obejdzie. /usage pokaże limity i termin odnowienia. Przy logowaniu abonamentem otwarta sesja sama wróci do przerwanego zadania po odnowieniu limitu, więc nie ponawiaj go w pętli.

Nie nadawaj szerokich uprawnień tylko po to, aby usunąć komunikat. Na większym projekcie pracuj dopiero po udanej próbie w małym folderze. Gdy pierwsze zadania pójdą gładko, kolejny krok opisuje tekst o tym, jak skutecznie współpracować z Claude Code.

Zrób jedną rzecz: zarezerwuj dziś 15 minut. Zainstaluj Claude Code poleceniem dla swojego systemu, sprawdź claude --version, załóż folder claude-demo i uruchom w nim claude --permission-mode manual. Wpisz /status, żeby zobaczyć, z którego konta płacisz, a potem daj Claude zadanie z hello.js. Każdą zmianę przeczytaj, zanim wybierzesz Yes.