Aplikacja z Claude Code: tutorial iPhone krok po kroku

Tworzenie aplikacji z Claude Code: krótka odpowiedź

Żeby stworzyć aplikację z Claude Code, potrzebujesz płatnego dostępu do Claude Code (zgodna subskrypcja albo Console z rozliczeniem za użycie), Node.js, iPhone'a z Expo Go i projektu Expo. Piszesz plik CLAUDE.md, który opisuje twój stack i zasady. Prosisz o jeden ekran naraz i testujesz każdy ekran na iPhonie. Na koniec wysyłasz aplikację na TestFlight przez EAS.

Ten tutorial uzupełnia mój poradnik jak stworzyć aplikację iOS z AI, który wyjaśnia, w czym AI jest dobra, a w czym zawodzi. Tutaj przechodzimy do praktyki: komendy, pliki, prompty.

Codziennie koduję swoje aplikacje iOS w Claude Code i Cursorze. Mój stack: React Native, Expo, EAS, RevenueCat i Supabase. Solys, budzik z minigrami, i TradaZen, aplikacja do treningu tradingu, są opublikowane w App Store. Nolera i Clic zostały odrzucone przez Apple, a potem poprawione. Wszystko, co poniżej, wynika z tej pracy.

Jeśli chcesz zobaczyć tę metodę zastosowaną w opublikowanej aplikacji, opisałem drogę TradaZen, od pierwszego commita po odrzucenia przez Apple i zmiany kierunku. To studium przypadku uzupełnia kroki z tego tutoriala.

Krok 1: przygotuj wymagania

Zanim wpiszesz pierwszą komendę, sprawdź, czy masz to wszystko.

Płatne konto Claude

Claude Code nie wchodzi w darmowy plan claude.ai. Według dokumentacji Anthropic potrzebujesz konta Pro, Max, Team, Enterprise albo Console. Plan Pro wystarczy na start, w ramach jego limitów użycia.

Node.js i terminal

Expo wymaga Node.js w wersji LTS, na macOS, Windowsie lub Linuksie. Claude Code działa na macOS 13 lub nowszym, Windowsie 10 lub nowszym i głównych dystrybucjach Linuksa.

iPhone i Expo Go

Zainstaluj Expo Go z App Store na iPhonie, żeby testować pierwsze ekrany bez kompilowania własnej aplikacji. Zanim utworzysz projekt, sprawdź na stronie Expo Go, która wersja SDK pasuje do twojej instalacji. Najnowsze SDK i wersja dostępna w App Store nie zawsze pojawiają się w tym samym momencie: Expo opisało na przykład takie przesunięcie w maju 2026. Nie zaczynaj więc od numeru wersji znalezionego w starym tutorialu. Jeśli chcesz używać własnych modułów natywnych, zaplanuj development build.

Mac? Nie jest wymagany

Buildy iOS są kompilowane na serwerach Expo przez EAS Build, z wersją Xcode wybraną przez twoje SDK Expo (ITMS-90725), a EAS Submit działa na macOS, Linuksie i Windowsie. Możesz więc dojść aż do TestFlight z peceta. Poradnik jak opublikować aplikację iOS bez Maca opisuje cały ten proces.

Konto Apple Developer, później

Nie potrzebujesz go, żeby kodować i testować w Expo Go z App Store. Staje się obowiązkowe w momencie wysyłki aplikacji na TestFlight. Wrócimy do tego w kroku 7.

Krok 2: zainstaluj Claude Code

Na macOS, Linuksie lub WSL Anthropic zaleca natywny instalator:

curl -fsSL https://claude.ai/install.sh | bash

Na Windowsie, w PowerShellu:

irm https://claude.ai/install.ps1 | iex

Potem sprawdź, czy instalacja się udała:

claude --version

Jeśli wolisz npm, komenda to npm install -g @anthropic-ai/claude-code. Nie dodawaj przed nią sudo, dokumentacja wprost to odradza.

Przy pierwszym uruchomieniu claude otwiera się przeglądarka, w której logujesz się na swoje konto. Potem po prostu piszesz po polsku: Claude czyta twoje pliki, proponuje zmiany i uruchamia komendy, za twoją zgodą.

Krok 3: utwórz projekt Expo

Przejdź do folderu, w którym trzymasz projekty, i uruchom:

npx create-expo-app@latest my-app
cd my-app
npx expo start

Jeśli narzędzie da ci wybór między zgodnością z Expo Go z App Store a najnowszym SDK, w tym ćwiczeniu wybierz zgodność. W każdym razie, zanim pójdziesz dalej, sprawdź, czy utworzona wersja jest obsługiwana przez Expo Go zainstalowane na twoim iPhonie. Development build przygotujesz, kiedy projekt będzie go potrzebował.

W terminalu pojawi się kod QR. Zeskanuj go aparatem iPhone'a: aplikacja otworzy się w Expo Go. Za pierwszym razem często blokuje jeden szczegół: Expo Go otworzy twój projekt tylko wtedy, gdy Expo CLI i Expo Go są zalogowane na to samo konto Expo. Uruchom npx expo login na komputerze i zaloguj się tym samym kontem w aplikacji.

Dlaczego Expo, a nie Swift? Claude bardzo dobrze zna React Native, a ty testujesz bez Maca. Wyjaśniam ten wybór na stronie React Native i Expo dla aplikacji mobilnej.

Pamiętaj o jednym ograniczeniu Expo Go: zawiera tylko moduły natywne, które ma już wbudowane. Gdy tylko dodasz bibliotekę natywną, której nie zna, na przykład zakupy w aplikacji, będziesz potrzebować development builda. Przy pierwszych ekranach to nie problem.

Wybierz właściwe środowisko testowe

Expo Go, development build i TestFlight nie dowodzą tego samego. Expo opisuje development build jako twoją własną aplikację testową, z modułami natywnymi, których potrzebuje twój projekt.

Co chcesz sprawdzić	Gdzie testować	Czego ten test nie pokaże
Wyświetlenie pierwszego ekranu i przetestowanie nawigacji	Expo Go, ze zgodnym SDK	Działania modułów natywnych, których nie ma w Expo Go
Użycie biblioteki natywnej dodanej do projektu	Development build zawierający tę bibliotekę	Wersji dystrybuowanej ani jej akceptacji przez Apple
Przejście aplikacji dla testerów, a potem test zakupów	Build wysłany na TestFlight i poprawnie skonfigurowane produkty	Prawdziwej płatności klienta ani zatwierdzenia do sprzedaży

Zanim dodasz zależność, zapytaj Claude: „Czy jest zgodna z moim SDK i obecnym środowiskiem testowym? Czy trzeba ponownie skompilować aplikację? Oprzyj odpowiedź na dokumentacji”. Unikniesz wieczoru spędzonego na naprawianiu modułu, którego Expo Go po prostu nie potrafi załadować, albo SDK odrzuconego przy wysyłce za niepubliczne API.

Krok 4: napisz plik CLAUDE.md projektu

To najbardziej opłacalny krok. Claude Code potrafi przechowywać pamięć projektu, ale jego zasady musisz zapisać wprost. Plik CLAUDE.md w katalogu głównym projektu daje wspólne instrukcje dla wszystkich sesji. To tam zapisujesz to, czego Claude nie zgadnie.

W folderze projektu uruchom claude, a potem wpisz /init. Według dokumentacji Claude analizuje projekt i generuje pierwszy CLAUDE.md z komendami i konwencjami, które znajdzie. Potem uzupełniasz go swoimi zasadami. Anthropic zaleca, żeby nie przekraczać 200 linii: im dłuższy plik, tym słabiej instrukcje są przestrzegane.

Oto krótki przykład, zbliżony do tego, czego używam:

# Moja aplikacja

## Stack

- Expo (SDK z create-expo-app), React Native, TypeScript strict
- Nawigacja: Expo Router, jeden plik na ekran w app/
- Dane: Supabase (później), nigdy żadnego sekretnego klucza w aplikacji

## Zasady

- Jeden ekran naraz. Nie ruszaj plików spoza zakresu prośby.
- Żadnych stałych wysokości w punktach: rozmiary względne do ekranu,
  ScrollView, jeśli treść może się nie zmieścić.
- Każdy ekran obsługuje 3 stany: ładowanie, pusty, błąd.
- Teksty interfejsu po polsku, z polskimi znakami.
- Zanim zmienisz więcej niż 2 pliki: zaproponuj plan i poczekaj na moją zgodę.

## Komendy

- Uruchomienie: npx expo start
- Testy: użyj skryptu, który faktycznie jest w package.json.
  Jeśli jeszcze go nie ma, zgłoś to; nie ogłaszaj zaliczonych testów.
- Typy: npx tsc --noEmit
- Po każdej zmianie: uruchom testy i typy, potem powiedz mi,
  co się zmieniło i jak to sprawdzić na iPhonie.

Zasada o stałych wysokościach nie jest tu przypadkiem. Wrócimy do niej w kroku 6.

Krok 5: promptuj jeden ekran naraz

„Zrób mi aplikację do śledzenia nawyków z subskrypcją” daje ogromny, kruchy projekt, którego nie da się przejrzeć. Metoda, która działa, jest odwrotna: jedna prośba, jeden ekran, wynik, który przetestujesz w pięć minut.

Zacznij od planu

Przy wszystkim, co dotyka kilku plików, przełącz się w tryb planowania. Naciskaj Shift+Tab, aż na pasku stanu zobaczysz plan mode on. W tym trybie Claude czyta pliki i proponuje plan, ale niczego nie zmienia bez twojej zgody. Czytasz, poprawiasz, zatwierdzasz.

Pierwszy prompt porządkujący wygląda tak:

Chcę aplikację do śledzenia nawyków. Wersja 1: jedna funkcja,
odhaczanie dzisiejszych nawyków. Zaproponuj listę ekranów i
strukturę folderów. Na razie niczego nie koduj.

Opisz ekran, jego stany i przypadki graniczne

Dalej jeden prompt na ekran. Im więcej przypadków granicznych nazwiesz, tym rzadziej Claude o nich zapomni:

Utwórz ekran app/index.tsx z listą dzisiejszych nawyków.
- Każdy wiersz: nazwa nawyku, pole wyboru, aktualna seria.
- Stan pusty: tekst i przycisk „Dodaj nawyk”.
- Stan ładowania i stan błędu z przyciskiem „Spróbuj ponownie”.
- Na razie dane pochodzą z lokalnej tablicy.
- Musi się mieścić zarówno na iPhonie SE, jak i na największym iPhonie:
  bez stałej wysokości, lista się przewija.
Na koniec uruchom testy i typy.

Poprawiaj bez przepisywania wszystkiego

Kiedy jakiś szczegół nie pasuje, bądź precyzyjny i ogranicz zakres:

Na moim iPhonie przycisk „Dodaj nawyk” chowa się pod dolnym paskiem,
kiedy lista jest długa. Popraw tylko ten problem w app/index.tsx,
nie ruszając innych plików. Wyjaśnij przyczynę.

Możesz też wkleić zrzut ekranu do terminala: Claude go odczyta.

Ćwiczenie: nawyk, który zostaje odhaczony po ponownym uruchomieniu

To ćwiczenie do wykonania w twoim projekcie, a nie zrzut już gotowej funkcji. Cel: przejść od wygenerowanego ekranu do zachowania, które da się sprawdzić. Nie wymaga ani konta użytkownika, ani zakupu w aplikacji.

1. Zostaw jeden lokalny nawyk o nazwie „Czytaj 10 minut”.
2. Poproś o pole wyboru i lokalny zapis zgodny z twoim projektem Expo.
3. Poproś agenta, żeby podał zmienione pliki, ewentualną zależność i faktycznie uruchomione komendy.
4. Zainstaluj lub otwórz aplikację na iPhonie i wykonaj poniższe sprawdzenia.

Na bazie istniejącego ekranu spraw, żeby nawyk „Czytaj 10 minut”
dało się odhaczyć, i zachowaj jego stan po zamknięciu i ponownym otwarciu aplikacji.
Użyj lokalnego magazynu zgodnego z zależnościami projektu.
Nie twórz konta, serwera, subskrypcji ani dodatkowych statystyk.
Zanim zaczniesz kodować, wyjaśnij, jak obsłużysz ładowanie oraz błąd
odczytu lub zapisu. Potem wprowadź ograniczoną zmianę.
Na koniec: zmienione pliki, uruchomione komendy, nieprzetestowane ograniczenia
i dokładne kroki, żeby sprawdzić wynik na iPhonie.

Działanie na iPhonie	Oczekiwany wynik	Jeśli się nie uda
Pierwsze otwarcie aplikacji	Nawyk i jego pole są widoczne, bez błędu	Sprawdź stan początkowy i ładowanie z magazynu
Odhaczenie, zamknięcie i ponowne otwarcie	Nawyk zostaje odhaczony	Sprawdź zapis, a potem odczyt tego samego klucza
Odznaczenie i ponowne uruchomienie	Nawyk zostaje odznaczony	Sprawdź, czy wartość false też jest zapisywana
Powtórzenie wszystkiego w trybie samolotowym	Lokalna funkcja nadal działa	Znajdź zależność sieciową dodaną bez powodu
Powiększenie rozmiaru tekstu	Nazwa i kontrolka pozostają dostępne	Usuń ograniczenia, które ucinają lub zasłaniają akcję

Nie proś „przepisz wszystko”, jeśli jeden wiersz nie przejdzie. Opisz działanie, oczekiwany wynik i to, co faktycznie widzisz. Na przykład: „Po ponownym uruchomieniu pole znów jest puste, choć je odhaczyłem. Wyjaśnij przyczynę i popraw zapisywanie stanu, nie zmieniając wyglądu”.

Pobierz szablon CLAUDE.md i listę kontrolną (.md). Otwórz go w edytorze albo w aplikacji do notatek. Zanim przekażesz go agentowi, dopasuj komendy do swojego projektu.

Krok 6: przeglądaj i testuj

Claude Code pisze kod, który wygląda na poprawny. Tylko twoje testy i twój iPhone powiedzą ci, czy taki jest.

Testy, żeby nie psuć tego, co działa

Im bardziej aplikacja rośnie, tym większe ryzyko, że każda prośba zepsuje już sprawdzony ekran. Projekt utworzony przez Expo nie ma testów: najpierw poproś Claude o instalację Jest z jest-expo, jak zaleca dokumentacja Expo. Potem poproś o testy dla ważnej logiki (liczenie serii, walidacja formularza) i każ je uruchamiać po każdej zmianie. Dlatego komendy testowe są zapisane w CLAUDE.md: Claude je uruchamia, bez przypominania. Z plikiem zasad i testami AI dużo rzadziej psuje to, co już działało.

Przeglądaj każdą zmianę

Nie musisz rozumieć każdej linii. Musisz wiedzieć, które pliki się zmieniły i dlaczego. Jeśli Claude ruszył plik niezwiązany z prośbą, zapytaj o powód, zanim zaakceptujesz. Potem zadaj pytanie: „co tu może się zepsuć?”.

Sprawdzaj na małym i dużym iPhonie

Ta lekcja kosztowała mnie najwięcej. Solys została odrzucona przez Apple na podstawie wytycznej 2.1: demo w onboardingu było niemożliwe do wygrania na iPadzie Air, gdzie aplikacja działała w trybie zgodności z iPhone'em. Przyczyna: wysokości zakodowane w stałych punktach, a nie względem rozmiaru ekranu. Na moim iPhonie wszystko było w porządku. Kod był przejrzany, testy zielone. Żadne narzędzie nie spojrzało na ekran w innym rozmiarze.

Od tamtej pory sprawdzam każdy ekran przynajmniej na najmniejszym i największym iPhonie. Jeśli masz tylko jeden telefon, wystarczy symulator Xcode na Macu albo znajomy z innym modelem. Zwróć szczególną uwagę na długie teksty, otwartą klawiaturę w formularzach i przyciski przypięte do dołu.

Z czym Claude Code radzi sobie słabo

Claude Code świetnie radzi sobie z ekranami i logiką. Poza twoim folderem jest dużo mniej niezawodny.

Podpisywanie i certyfikaty

Bez autoryzowanego połączenia z twoim kontem Apple Claude nie zna jego stanu. Może wymyślić procedurę certyfikatów, która miesza Xcode i Expo. Zostaw podpisywanie EAS: dokumentacja Expo wyjaśnia, że EAS CLI może wygenerować i przechowywać te pliki za ciebie, po połączeniu z twoim kontem Apple Developer.

App Store Connect

Strona aplikacji, deklaracje prywatności, zrzuty ekranu i linki prawne to dane, które trzeba zweryfikować w App Store Connect. Claude Code może teraz działać w zalogowanej przeglądarce przez swoją integrację z Chrome, jeśli ma potrzebne dostępy. To nie gwarantuje, że pola są poprawne: przeczytaj informacje, sprawdź używane konta i sam zatwierdź zobowiązania oraz wysyłkę do recenzji.

Subskrypcje

Napisanie paywalla zajmuje dziesięć minut. Zgranie produktów z App Store Connect, ich konfiguracji w RevenueCat i kodu to zupełnie inna historia. Identyfikator różniący się o jeden znak i paywall u recenzenta zostaje pusty. Najczęstsze pułapki opisałem w błędach początkujących przy paywallu iOS.

Przypadki graniczne

Bez instrukcji Claude obsługuje typowy scenariusz. Brak sieci, pusta lista, przerwany zakup: to ty musisz je nazwać.

Bezpieczeństwo Supabase

Kiedy Claude tworzy tabele w Supabase, sprawdź, czy zabezpieczenia na poziomie wierszy (RLS) są włączone, z politykami, które ograniczają każdego użytkownika do jego własnych danych. Sprawdź też, czy żaden sekretny klucz nie trafił do kodu aplikacji. Zapisz te dwa zakazy w CLAUDE.md, gdy tylko podłączysz bazę.

Krok 7: przejdź na TestFlight z EAS

Twoje ekrany zostały sprawdzone w Expo Go albo w development buildzie, zależnie od użytych modułów. Teraz czas na build, który trafi do testerów.

Przygotuj EAS

Teraz potrzebujesz płatnego konta Apple Developer: jak przypomina Expo, jest obowiązkowe, żeby wysłać aplikację do App Store. Potem zainstaluj narzędzie Expo i skonfiguruj projekt:

npm install --global eas-cli
eas login
eas build:configure

Dodaj unikalny bundle identifier w app.json, w ios.bundleIdentifier, na przykład com.yourname.myapp.

Skompiluj i wyślij

eas build --platform ios --profile production
eas submit --platform ios

Pierwsza komenda kompiluje aplikację na serwerach Expo. Przy pierwszym uruchomieniu EAS zaproponuje połączenie z twoim kontem Apple, żeby utworzyć certyfikaty. Druga wysyła build do App Store Connect. Możesz też zrobić wszystko naraz przez eas build --platform ios --auto-submit.

Build musi zostać przetworzony przez Apple, zanim pojawi się w TestFlight, a to przetwarzanie może go odrzucić, na przykład z błędem ITMS-90717 za przezroczystą ikonę. Udana wysyłka nie oznacza więc, że da się go już zainstalować: sprawdź jego status w App Store Connect. Testerów wewnętrznych, zewnętrznych i recenzję wersji beta wyjaśniam w poradniku TestFlight: jak testować aplikację na iPhone'a.

Powtórz sprawdzenia z kroku 6 na tym buildzie. Aplikacja, która działa w Expo Go, nadal może się wysypać w produkcji, na przykład gdy brakuje modułu natywnego.

Ile to naprawdę kosztuje

Oto ceny podane przez usługi i sprawdzone 27 września 2026, w dolarach. Faktycznie naliczona kwota zależy też od twojego regionu, podatków i zużycia: sprawdź ofertę, zanim wykupisz.

• Subskrypcja Claude: plan Pro kosztuje 20 $ miesięcznie albo 17 $ miesięcznie przy płatności rocznej. Plany Max zaczynają się od 100 $ miesięcznie, dla większego użycia.
• Konto Apple Developer: 99 $ rocznie, obowiązkowe dla TestFlight i App Store.
• EAS: darmowy plan Expo obejmuje 15 buildów iOS miesięcznie, w kolejce o niskim priorytecie. Plan Starter kosztuje 19 $ miesięcznie plus dodatkowe użycie.

Dla małego prototypu Pro i darmowy plan EAS mogą wystarczyć jako baza, jeśli zmieścisz się w ich limitach. Przed TestFlight dolicz konto Apple, a potem osobno policz usługi, których naprawdę potrzebujesz: bazę danych, storage czy płatne API. Szablon budżetu pierwszej aplikacji pomaga rozpisać te pozycje. Musisz też zaplanować czas na konfigurację i sprawdzanie.

Uczciwe ograniczenia i gdzie się utyka

Claude Code zmienił to, kto może stworzyć aplikację na iPhone'a. Nie zmienił tego, czego Apple wymaga, żeby ją opublikować. Odrzucenie przychodzi szybko: Solys je dostała, Nolera i Clic też. Najczęstsze powody opisuję w tekście dlaczego Apple odrzuca aplikację.

Z tym tutorialem dojdziesz sam do TestFlight. Najczęściej utyka się później: podłączenie subskrypcji, przygotowanie materiałów dla recenzenta, zrozumienie odrzucenia. Jeśli chcesz zobaczyć cały proces, przeczytaj stronę jak stworzyć aplikację na iPhone'a.

Na ten etap iOS Kit zbiera kod startowy moich aplikacji, razem z subskrypcjami, skille Claude Code do każdego etapu i Apple Review Kit. Pełną ścieżkę znajdziesz na stronie kurs Claude Code: jak stworzyć aplikację iOS.

Już utknąłeś i nie wiesz, na czym? Darmowa diagnoza pokaże ci, co naprawdę cię blokuje, i wyśle ci moją checklistę przeciw odrzuceniom przez Apple.

Najczęściej zadawane pytania

Czy można stworzyć aplikację na iPhone'a z Claude Code, nie umiejąc programować?

Tak, jeśli chodzi o ekrany i prostą logikę, pod warunkiem że przeglądasz i testujesz każdy krok. Nie, jeśli liczysz, że nie będziesz musiał niczego rozumieć. Musisz umieć przeczytać komunikat o błędzie, uruchomić komendę i sprawdzić, co Claude zmienił. Tego szybko uczysz się w trakcie budowania.

Czy Claude Code jest darmowy?

Nie. Claude Code wymaga konta Pro, Max, Team, Enterprise albo Console. Darmowy plan claude.ai go nie obejmuje. Plan Pro wystarczy na start, ale musisz pilnować limitów użycia.

Czy potrzebuję Maca, żeby stworzyć aplikację iOS z Claude Code?

Nie. Kodujesz na dowolnym komputerze, testujesz w Expo Go na iPhonie, a EAS kompiluje i wysyła aplikację z serwerów Expo. Mac przydaje się do symulatora, ale nie jest wymagany.

Claude Code czy Cursor do aplikacji React Native?

Używam obu, codziennie. Claude Code działa w terminalu i sam robi zmiany i odpala testy, jedno po drugim. Cursor to edytor. Metoda liczy się bardziej niż narzędzie: zasady, jeden ekran naraz, testy.

Ile czasu zajmuje opublikowanie pierwszej aplikacji z Claude Code?

To zależy od wielkości aplikacji i twojego czasu. Aplikacja z jedną funkcją idzie dużo szybciej. Najmniej przewidywalna część to recenzja Apple.

Czy Claude Code może skonfigurować subskrypcje w aplikacji?

Może napisać kod paywalla i RevenueCat. Z podłączonymi narzędziami i potrzebnymi uprawnieniami może też działać w konsolach. Nigdy nie zakładaj, że skoro jest kod, to produkty są skonfigurowane: sprawdź identyfikatory, ceny i uprawnienia po zakupie, a potem przetestuj zakup i przywracanie zakupów na TestFlight. Częste błędy w paywallach iOS podpowiedzą ci, co sprawdzić.