Claude Code w firmie – nie tylko dla programistów

Claude Code w firmie bez programowania: czym jest i jakie problemy rozwiązuje

Między zadaniem „trzeba uporządkować te dane” a gotowym wynikiem często stoi techniczna przeszkoda: brak odpowiedniej funkcji w arkuszu, konieczność połączenia kilku plików albo napisania krótkiego skryptu. Pracownik zna proces i wie, co chce uzyskać, lecz nie potrafi przełożyć tego na kod. Claude Code może pomóc pokonać tę barierę — pozwala opisać zadanie zwykłym językiem, a następnie zlecić asystentowi wykonanie technicznej części pracy.

Czym jest Claude Code i czym różni się od zwykłego czatu?

Claude Code to narzędzie firmy Anthropic stworzone przede wszystkim do pracy z kodem. Działa jako asystent, który może korzystać z udostępnionego środowiska pracy: czytać pliki, tworzyć je i modyfikować, a także uruchamiać polecenia oraz sprawdzać rezultaty. Zakres tych działań zależy od konfiguracji, dostępnych narzędzi i nadanych uprawnień.

Najważniejsza różnica nie polega na tym, że Claude Code lepiej opisuje rozwiązanie, lecz na tym, że może uczestniczyć w jego wykonaniu. W typowej rozmowie z czatem użytkownik otrzymuje instrukcję lub fragment kodu, który musi sam przenieść do odpowiedniego programu. Claude Code może pracować bezpośrednio na plikach zadania i przechodzić od analizy do zmian oraz ich weryfikacji. Granica nie jest jednak absolutna: również interfejsy czatowe mogą oferować obsługę plików i wykonywanie kodu. Claude Code wyróżnia sposób pracy oparty na działaniu w środowisku projektu, a nie wyłącznie na wymianie wiadomości.

Co oznacza „bez programowania” w praktyce biznesowej?

Nie chodzi o to, że kod przestaje być potrzebny. W wielu zadaniach powstaje, ale użytkownik nie musi pisać go samodzielnie. Jego rolą jest określenie celu, wyjaśnienie reguł biznesowych i ocena, czy wynik odpowiada potrzebie. Zamiast wybierać bibliotekę czy konstruować pętlę, opisuje, jakie informacje mają zostać zachowane, co uznać za błąd i jak powinien wyglądać rezultat.

To odróżnia Claude Code także od klasycznych narzędzi no-code. W takich narzędziach użytkownik zwykle buduje proces z gotowych elementów w interfejsie graficznym. Tutaj podstawą jest rozmowa, a rozwiązanie może przybrać postać kodu dopasowanego do konkretnego zadania. Daje to większą swobodę, ale nie zapewnia automatycznie prostszej obsługi ani bezbłędnego działania. Brak konieczności pisania kodu nie oznacza braku potrzeby rozumienia procesu i sprawdzania efektów.

Jakie problemy pomaga rozwiązać w firmie?

Claude Code jest szczególnie przydatny tam, gdzie zadanie ma jasne reguły, lecz jego ręczne wykonanie wymaga wielu powtarzalnych czynności. Może ograniczać trzy częste bariery:

• Nadmierną pracę ręczną. Powtarzalne przekształcanie informacji, porównywanie zestawień czy przygotowywanie danych do raportu można opisać jako zestaw reguł i wesprzeć automatyzacją.
• Lukę między dostępnym oprogramowaniem a rzeczywistą potrzebą. Gdy firmowy system nie oferuje drobnej, potrzebnej funkcji, czasem wystarczy niewielkie narzędzie pomocnicze zamiast rozbudowy całej aplikacji.
• Trudność w przekazaniu pomysłu zespołowi technicznemu. Wstępne, działające rozwiązanie może pomóc sprawdzić założenia i doprecyzować wymagania, zanim firma zdecyduje się na większe wdrożenie.

Potencjalna korzyść nie sprowadza się więc do szybszego tworzenia kodu. Dla osoby z finansów, operacji, marketingu czy administracji ważniejsze może być skrócenie drogi od rozpoznanego problemu do wyniku, który da się ocenić. Nie każde zadanie uzasadnia jednak użycie takiego narzędzia: jeśli gotowa funkcja używanego programu rozwiązuje problem prościej, zwykle warto zacząć właśnie od niej.

Claude Code nie zastępuje też specjalisty przy rozwiązaniach krytycznych dla działalności firmy. Najbardziej realistyczna rola tego narzędzia to techniczne wsparcie osoby, która zna swoją dziedzinę: pomaga wykonać pracę, ale nie przejmuje odpowiedzialności za poprawność reguł, interpretację danych ani decyzję o wykorzystaniu rezultatu.

Przygotowanie do pracy: dostęp, środowisko, dane wejściowe i zasady organizacyjne

Pierwsze zadanie w Claude Code warto zacząć nie od polecenia, lecz od ustalenia, gdzie narzędzie będzie pracować, do jakich materiałów otrzyma dostęp i po czym rozpoznamy poprawny wynik. W Cognity często słyszymy pytania, jak przygotować się do takiej pracy w praktyce – odpowiadamy na nie także na blogu. Osoba nietechniczna nie musi samodzielnie konfigurować całego środowiska. Powinna jednak wiedzieć, które elementy przygotowuje sama, a które wymagają pomocy IT lub administratora firmowego konta.

Dostęp: konto, sposób logowania i rozliczenia

Najpierw sprawdź, czy firma udostępnia Claude Code i jaki sposób uwierzytelniania zatwierdziła. Nie zakładaj, że samo posiadanie konta do rozmów z Claude oznacza dostęp do Claude Code — zależy to od planu i konfiguracji organizacji. Możliwe są różne ścieżki korzystania z usługi, w tym dostęp powiązany z subskrypcją lub rozliczany przez API. Aktualne uprawnienia, limity i sposób naliczania kosztów powinien potwierdzić administrator.

Przed rozpoczęciem pilotażu ustal również właściciela dostępu oraz osobę odpowiedzialną za kontrolę wydatków. To szczególnie ważne wtedy, gdy zadanie wymaga wielu prób: koszt pracy nie musi odpowiadać liczbie gotowych plików, ponieważ po drodze narzędzie może analizować materiały, wprowadzać poprawki i ponawiać testy.

Środowisko: miejsce do pracy, nie tylko okno rozmowy

Claude Code może działać w terminalu, czyli oknie służącym do wydawania poleceń, lub przez integrację z obsługiwanym edytorem. Wybór interfejsu wpływa przede wszystkim na wygodę pracy. Terminal pozwala prowadzić zadanie za pomocą poleceń tekstowych, a edytor ułatwia równoczesne przeglądanie plików i proponowanych zmian. Dla początkującej osoby najlepszy będzie wariant, który firmowe IT potrafi skonfigurować i wspierać.

W odróżnieniu od zwykłej rozmowy z asystentem Claude Code może pracować na plikach w udostępnionym środowisku oraz uruchamiać dostępne w nim narzędzia. Nie oznacza to jednak, że automatycznie ma wszystkie programy potrzebne do wykonania zadania. Jeżeli rozwiązanie wymaga konkretnego interpretera, biblioteki lub aplikacji, ich dostępność trzeba wcześniej zweryfikować. Instalowanie dodatkowych składników warto pozostawić osobie odpowiedzialnej za środowisko.

Na start przygotuj osobny folder roboczy: z kopiami materiałów wejściowych, miejscem na wyniki i krótkim opisem zadania. Oddzielenie plików źródłowych od wygenerowanych ogranicza pomyłki i ułatwia porównywanie kolejnych wersji. Nie zaczynaj od katalogu, w którym leżą wszystkie dokumenty działu.

Dane wejściowe: mała próbka, jasne znaczenie pól

Do pierwszej próby lepiej przygotować niewielki, reprezentatywny zestaw danych niż komplet archiwów. Próbka powinna odzwierciedlać rzeczywisty układ plików i zawierać typowe odstępstwa, na przykład brakujące wartości czy różne formaty dat. Wybór materiałów musi być zgodny z firmowymi zasadami dopuszczania danych do pracy z AI.

Do plików dołącz krótki opis obejmujący:

• Źródło i format: skąd pochodzą materiały, jaki mają układ i które pola są istotne.
• Znaczenie danych: co oznaczają skróty, jednostki, statusy oraz puste komórki.
• Oczekiwany rezultat: jaki plik lub dokument ma powstać i kto będzie z niego korzystać.
• Kryteria odbioru: co sprawdzisz, aby uznać wynik za poprawny, na przykład zachowanie liczby rekordów lub zgodność sum kontrolnych.

Zasady organizacyjne: kto zleca, kto zatwierdza

Jeszcze przed pierwszym zadaniem rozdziel odpowiedzialność. Właściciel procesu określa cel i znaczenie danych, IT wspiera konfigurację, a wyznaczona osoba ocenia rezultat. Ustal też granicę między eksperymentem a rozwiązaniem używanym przez zespół: udana próba nie jest sama w sobie zgodą na wdrożenie.

Stałe ustalenia zapisuj w jednym miejscu. Claude Code obsługuje pliki CLAUDE.md, w których można umieścić instrukcje dotyczące projektu, takie jak nazewnictwo wyników czy sposób opisywania zmian. Taki dokument pomaga zachować spójność pracy, ale nie zastępuje ustawień uprawnień ani firmowych procedur. Przygotowanie jest zakończone wtedy, gdy wiadomo nie tylko, jak rozpocząć zadanie, lecz także kto odbierze jego wynik.

Praktyczne zastosowania dla nie-programistów: arkusze, porządkowanie danych, proste narzędzia, API, makra i prototypy

Comiesięczne scalanie zestawień, poprawianie dat w eksporcie czy przenoszenie danych między systemami często pochłania więcej czasu niż ich późniejsza analiza. To zadania, w których Claude Code może pomóc osobom z finansów, marketingu, sprzedaży i operacji. Nie trzeba samodzielnie pisać kodu, ale trzeba znać reguły swojej pracy: wiedzieć, co oznaczają dane, jaki wynik jest potrzebny i które wyjątki mają znaczenie.

Poszczególne zastosowania różnią się przede wszystkim miejscem wykonania zadania i sposobem korzystania z rozwiązania. Formuła działa w arkuszu, makro automatyzuje czynności w aplikacji, a skrypt może przetwarzać pliki poza nią. Claude Code pomaga przygotować takie rozwiązania; możliwość ich uruchomienia zależy od dostępnych narzędzi i uprawnień. Nie należy zakładać, że samodzielnie obsłuży dowolny program biurowy lub system firmowy.

Kiedy wystarczy arkusz, a kiedy warto wyjść poza niego?

Jeśli zadanie polega na obliczeniu wartości na podstawie kilku kolumn, formuła zwykle będzie prostsza w utrzymaniu niż osobny program. Makro ma sens wtedy, gdy problemem jest sekwencja powtarzanych czynności w tym samym skoroszycie. Skrypt warto rozważyć, gdy co tydzień trzeba przetworzyć wiele podobnych plików, a ręczne otwieranie każdego z nich staje się głównym obciążeniem.

Te rozwiązania mogą się uzupełniać. Dane pobrane przez API można uporządkować skryptem, a wynik zapisać w arkuszu, z którego zespół korzysta już na co dzień. Nie każda automatyzacja wymaga więc nowej aplikacji — czasem najlepszym efektem jest usunięcie kilku uciążliwych etapów z istniejącego procesu.

Proste narzędzie a prototyp — podobna forma, inny cel

Niewielki kalkulator używany regularnie powinien poprawnie obsługiwać uzgodnione dane i przewidywalne błędy. Prototyp może jedynie pokazywać, jak taki kalkulator miałby działać: jakie pola zawierać, co wyświetlać i czy rzeczywiście ułatwiać pracę. Działający ekran nie oznacza jeszcze, że rozwiązanie nadaje się do codziennego użytku. Ta różnica pomaga ustalić, czy zespół potrzebuje testu pomysłu, czy narzędzia, na którego wynikach będzie polegać.

Co wnosi osoba, która nie programuje?

Kluczowa jest wiedza o procesie. Claude Code może przygotować mechanizm wykrywania duplikatów, ale to użytkownik musi określić, czy dwa rekordy z tym samym numerem oznaczają błąd, czy poprawne pozycje jednego zamówienia. Podobnie przy raportach: poprawne obliczenie nie gwarantuje poprawnej interpretacji biznesowej. Najlepsze zadania do takiej współpracy mają jasno określony wynik i reguły, które da się sprawdzić na znanych przykładach.

Mini-case studies: automatyzacja formuł i raportów w arkuszach — krok po kroku i gotowe prompty

W pracy z arkuszami Claude Code może pomóc na dwóch poziomach: przygotować formułę odpowiadającą konkretnej regule biznesowej albo opracować powtarzalny proces tworzenia raportu z pliku źródłowego. Pierwsze podejście sprawdza się, gdy chcesz dalej pracować samodzielnie w Excelu. Drugie — gdy regularnie odtwarzasz te same zestawienia, filtry i obliczenia.

W Cognity omawiamy automatyzację pracy z arkuszami zarówno od strony technicznej, jak i praktycznej — zgodnie z realiami pracy uczestników. Poniższe przykłady pokazują modelowy przebieg pracy, a nie wyniki wdrożenia w konkretnej firmie. Zakładamy eksport zamówień z kolumnami: Data, Region, Produkt, Ilość, Cena_netto, Rabat, Status. Cena dotyczy jednej sztuki, rabat jest zapisany jako ułamek od 0 do 1, a każdy wiersz odpowiada jednej pozycji zamówienia.

Przykład 1. Formuła wartości sprzedaży zgodna z zasadami rozliczenia

Problem: pracownik dopisuje do eksportu kolumnę z wartością sprzedaży. Ręczne kopiowanie i poprawianie formuł zajmuje czas, a pominięcie rabatu lub uwzględnienie anulowanej pozycji zmienia wynik zestawienia.

Krok 1. Opisz regułę, zanim poprosisz o formułę

W tym przykładzie do sprzedaży zaliczamy wyłącznie wiersze ze statusem Zrealizowane. Wartość pozycji to ilość pomnożona przez cenę jednostkową netto i przez jeden minus rabat. Wynik zaokrąglamy do dwóch miejsc po przecinku na poziomie każdej pozycji. Pozostałe statusy dają zero. To istotne ustalenie: suma kwot zaokrąglonych w wierszach może różnić się od kwoty zaokrąglonej dopiero po zsumowaniu.

Krok 2. Podaj układ arkusza i wersję programu

Nie wystarczy polecenie „napisz formułę sprzedaży”. Claude Code potrzebuje nazw kolumn, sposobu zapisu rabatu i informacji o środowisku. Polskie nazwy funkcji oraz średniki jako separatory dotyczą formuły wklejanej do odpowiednio skonfigurowanego Excela; nie należy automatycznie przenosić takiego zapisu do narzędzia generującego plik XLSX.

Gotowy prompt:

Przygotuj formułę do ręcznego wklejenia w polskim Excelu Microsoft 365, z separatorem argumentów będącym średnikiem. Dane są tabelą Excela o nazwie Zamowienia. Kolumny: Data, Region, Produkt, Ilość, Cena_netto, Rabat, Status.

Nowa kolumna ma nazywać się Wartosc_netto. Dla statusu Zrealizowane oblicz Ilość × Cena_netto × (1 − Rabat) i zaokrąglij wynik do dwóch miejsc po przecinku. Dla innych statusów zwróć 0. Rabat jest liczbą od 0 do 1, a Cena_netto jest ceną jednostkową.

Użyj odwołań strukturalnych. Podaj formułę, wyjaśnij ją prostym językiem i wskaż, gdzie ją wkleić. Nie ukrywaj błędów danych przez automatyczne zastępowanie ich zerem. Jeśli do poprawnego rozwiązania brakuje informacji, najpierw zadaj pytanie.

Krok 3. Sprawdź wynik na kilku znanych przypadkach

Dla 10 sztuk po 100 zł i rabatu 0,10 zrealizowana pozycja powinna dać 900 zł. Ten sam wiersz ze statusem Anulowane powinien dać zero, a zrealizowana pozycja bez rabatu — 1000 zł. Takie krótkie testy sprawdzają sens biznesowy formuły, nie tylko to, czy Excel ją przyjmuje.

Krok 4. Zastosuj formułę w całej tabeli

Po zatwierdzeniu testów wprowadź formułę jako kolumnę obliczeniową tabeli. Sprawdź również, czy obejmuje nowo dodane wiersze. Rezultatem jest jednoznaczna reguła obliczeń, którą można wykorzystać w filtrach, podsumowaniach i kolejnych raportach bez ręcznego poprawiania pojedynczych komórek.

Przykład 2. Miesięczny raport sprzedaży bez odtwarzania zestawienia od zera

Problem: co miesiąc trzeba otworzyć eksport, wybrać właściwy okres, podsumować sprzedaż według regionów i porównać ją z poprzednim miesiącem. Same czynności są proste, ale łatwo pominąć region albo pozostawić filtr z wcześniejszego raportu.

Krok 1. Zdefiniuj zawartość raportu

Ustal, że raport ma zawierać wartość sprzedaży netto dla każdego regionu w wybranym i poprzednim miesiącu, różnicę kwotową oraz zmianę procentową. Zakres dat powinien obejmować okres od pierwszego dnia miesiąca włącznie do pierwszego dnia następnego miesiąca wyłącznie. To pozwala poprawnie obsłużyć także daty zawierające godzinę.

Krok 2. Zleć przygotowanie powtarzalnego rozwiązania

W tym wariancie Claude Code może przygotować i — jeśli środowisko na to pozwala — uruchomić rozwiązanie tworzące raport XLSX. Nie musi przy tym sterować interfejsem Excela. Ważniejsze jest wskazanie pliku wejściowego, zasad obliczeń i oczekiwanego układu wyniku.

Gotowy prompt:

Przygotuj powtarzalny sposób generowania miesięcznego raportu XLSX z pliku zamowienia.xlsx, arkusz Dane. Miesiąc raportu ma być parametrem w formacie RRRR-MM.

Kolumny źródłowe: Data, Region, Produkt, Ilość, Cena_netto, Rabat, Status. Jeden wiersz to pozycja zamówienia, nie całe zamówienie. Cena_netto dotyczy jednej sztuki, Rabat jest ułamkiem od 0 do 1.

Uwzględniaj wyłącznie status Zrealizowane. Wartość pozycji obliczaj jako Ilość × Cena_netto × (1 − Rabat), zaokrągloną do dwóch miejsc po przecinku. Obliczenia wykonaj na danych źródłowych; nie polegaj na zapisanych wynikach formuł Excela.

Utwórz arkusz Podsumowanie: Region, Sprzedaż_bieżąca, Sprzedaż_poprzednia, Różnica_kwotowa, Zmiana_procentowa. Uwzględnij wszystkie regiony występujące w którymkolwiek z dwóch miesięcy. Gdy sprzedaż w poprzednim miesiącu wynosi zero, wpisz w zmianie procentowej „brak podstawy porównania”. Dodaj wiersz Razem; zmianę procentową dla niego oblicz z sum sprzedaży, nie jako średnią procentów regionów.

Dodaj arkusz Kontrola z liczbą uwzględnionych pozycji i sumą sprzedaży dla każdego miesiąca. Nie nazywaj liczby pozycji liczbą zamówień. Zapisz wynik jako osobny plik raport_RRRR-MM.xlsx.

Najpierw przedstaw plan i brakujące ustalenia. Dołącz krótką instrukcję ponownego uruchomienia oraz jasno wskaż, co zostało faktycznie wykonane i sprawdzone.

Krok 3. Uzgodnij sumy, zanim ocenisz wygląd raportu

Porównaj sumę sprzedaży w raporcie z niezależnym podsumowaniem odpowiednio przefiltrowanych danych źródłowych. Sprawdź region występujący tylko w jednym miesiącu oraz przypadek zerowej sprzedaży w okresie porównawczym. To właśnie takie sytuacje ujawniają błędy, których nie widać po samym formatowaniu tabeli.

Krok 4. Sprawdź ponowne uruchomienie

Wygeneruj zestawienie dla innego miesiąca, zmieniając wyłącznie parametr okresu. Jeśli trzeba ręcznie poprawiać zakresy lub dopisywać regiony, proces nie jest jeszcze w pełni powtarzalny. Gotowy rezultat to nie tylko pojedynczy raport, lecz także sprawdzony sposób jego odtworzenia po otrzymaniu kolejnego eksportu.

Mini-case studies: czyszczenie i standaryzacja danych oraz parser CSV

W pracy z danymi łatwo pomylić dwa różne problemy: nieprawidłowy odczyt pliku i niespójność jego zawartości. Parser CSV rozpoznaje strukturę danych — kolumny, rekordy i pola ujęte w cudzysłowy. Skrypt czyszczący porządkuje wartości według ustalonych reguł, na przykład usuwa zbędne spacje lub ujednolica zapis dat. Warto rozdzielić te zadania: nawet najlepsze reguły czyszczenia nie pomogą, jeśli przecinek w nazwie produktu zostanie błędnie potraktowany jako początek nowej kolumny.

Poniższe scenariusze pokazują, jak zlecić taką pracę Claude Code bez samodzielnego pisania kodu. To przykłady postępowania, a nie relacje z rzeczywistych wdrożeń.

Mini-case 1: uporządkowanie listy kontaktów przed importem

Sytuacja: lista kontaktów zawiera dodatkowe spacje, różne formaty dat, numery telefonów zapisane na kilka sposobów i powtarzające się adresy e-mail. Celem jest przygotowanie spójnego pliku do importu, ale bez zgadywania brakujących informacji i automatycznego usuwania potencjalnie ważnych rekordów.

Krok 1. Zleć diagnozę, zanim ustalisz reguły

Poproś Claude Code o skrypt, który odczyta plik i przygotuje raport jakości: nazwy kolumn, liczbę rekordów, puste wartości, spotykane formaty dat oraz kandydatów na duplikaty. Na tym etapie dane nie powinny być modyfikowane. Diagnoza pozwala odróżnić problem techniczny od decyzji biznesowej — na przykład ustalić, czy dwa kontakty z tym samym adresem e-mail rzeczywiście oznaczają duplikat.

Krok 2. Opisz, co wolno poprawić automatycznie

Reguły powinny być jednoznaczne. Usunięcie spacji na początku i końcu adresu e-mail jest czymś innym niż poprawienie jego domeny. Podobnie usunięcie nawiasów z numeru telefonu nie upoważnia skryptu do dopisania kodu kraju.

• Identyfikatory: traktuj jako tekst, aby zachować zera wiodące.
• Daty: przekształcaj tylko wartości zgodne z zatwierdzonymi formatami; zapis niejednoznaczny pozostaw do weryfikacji.
• Telefony: usuwaj wyłącznie uzgodnione znaki formatowania, zachowując początkowy plus i wszystkie cyfry.
• Duplikaty: oznaczaj według wybranego klucza, ale nie scalaj rekordów bez reguły rozstrzygania konfliktów.

Krok 3. Zleć skrypt i raport zmian

Oprócz uporządkowanego pliku poproś o raport zawierający numer rekordu, nazwę pola, wartość przed zmianą, wartość po zmianie i zastosowaną regułę. Dzięki temu wynik można sprawdzić, zamiast oceniać go wyłącznie po tym, czy plik otwiera się poprawnie.

Gotowy prompt do Claude Code:

Przygotuj skrypt w Pythonie do uporządkowania pliku kontakty.csv. Nie nadpisuj źródła.

Najpierw wykonaj analizę bez modyfikowania danych: pokaż kolumny, liczbę rekordów, braki, formaty dat i powtarzające się adresy e-mail. Jeśli nazwy kolumn lub format pliku są niejasne, zapytaj zamiast zgadywać.

Zaproponuj mapowanie kolumn i zaczekaj na moje zatwierdzenie. Następnie zastosuj reguły:
- identyfikatory odczytuj jako tekst; zachowaj zera wiodące;
- z adresów e-mail usuń tylko spacje na początku i końcu;
- w telefonach usuń spacje, myślniki i nawiasy; zachowaj plus oraz cyfry, nie dopisuj kodu kraju;
- daty w formatach YYYY-MM-DD oraz DD.MM.YYYY zamień na YYYY-MM-DD, sprawdzając ich poprawność kalendarzową;
- pozostałych dat nie zmieniaj; oznacz je do weryfikacji;
- powtarzające się niepuste adresy e-mail oznacz jako kandydatów na duplikaty; niczego nie usuwaj ani nie scalaj.

Zapisz osobno: dane uporządkowane, raport zmian i rekordy wymagające weryfikacji. Zachowaj wszystkie rekordy w pliku głównym. Podaj krótką instrukcję uruchomienia. Dodaj testy dla zera wiodącego, pustej wartości, błędnej daty i duplikatu.

Krok 4. Sprawdź, czy dane nie zniknęły

Liczba rekordów w pliku głównym powinna pozostać taka sama jak w źródle. Zweryfikuj także kilka zmienionych wartości oraz przypadków pozostawionych bez zmian. Dodatkowym testem jest ponowne przetworzenie uporządkowanego pliku: te same reguły nie powinny powodować kolejnych zmian wartości.

Mini-case 2: parser CSV odporny na przecinki, cudzysłowy i wielowierszowe pola

Sytuacja: eksport danych wygląda poprawnie w arkuszu, ale podczas przetwarzania część wartości trafia do niewłaściwych kolumn. Przyczyną może być separator wewnątrz opisu, cudzysłów zapisany zgodnie z regułami CSV albo podział wiersza wewnątrz jednego pola.

Rozwiązaniem nie jest dzielenie każdego wiersza po przecinku. Parser powinien korzystać z biblioteki obsługującej format CSV. Co ważne, liczba fizycznych linii pliku nie musi odpowiadać liczbie rekordów: jeden rekord może zawierać wielowierszowy opis.

Krok 1. Ustal warunki odczytu

Podaj separator, kodowanie i informację o nagłówku, jeśli je znasz. Jeżeli nie — poproś Claude Code o diagnozę i propozycję ustawień do zatwierdzenia. Automatyczne rozpoznawanie formatu jest pomocne, ale nie powinno oznaczać bezwarunkowego zaakceptowania wyniku.

Krok 2. Oddziel poprawny odczyt od poprawiania treści

Na tym etapie parser ma wiernie odtworzyć pola, zachowując je jako tekst. Nie powinien automatycznie zmieniać dat, liczb ani identyfikatorów. Jego zadaniem jest sprawdzenie struktury, w tym zgodności liczby pól z nagłówkiem, oraz wskazanie problemów uniemożliwiających wiarygodny odczyt.

Gotowy prompt do Claude Code:

Przygotuj w Pythonie parser pliku eksport.csv, używając standardowej biblioteki csv. Nie dziel danych ręcznie po przecinku ani po znakach nowej linii. Nie nadpisuj źródła.

Najpierw zaproponuj separator, kodowanie i sposób obsługi nagłówka. Ustawienia mają być jawnymi parametrami. Jeśli wykrywanie jest niejednoznaczne, poproś o potwierdzenie. Nie zastępuj po cichu znaków, których nie można zdekodować.

Parser ma poprawnie obsługiwać separator wewnątrz pola ujętego w cudzysłowy, podwojone cudzysłowy, wielowierszowe pola i puste wartości. Wszystkie pola zachowaj jako tekst.

Sprawdzaj liczbę pól względem nagłówka. Rekordy o niewłaściwej liczbie pól zapisz osobno z przyczyną odrzucenia i lokalizacją w źródle. Jeśli błąd składni CSV uniemożliwia wiarygodne ustalenie granic rekordów, przerwij przetwarzanie i wyraźnie oznacz wynik jako niekompletny.

Poprawne rekordy zapisz jako CSV w UTF-8, z nagłówkiem i przecinkiem jako separatorem. Przygotuj raport: liczba odczytanych rekordów, zaakceptowanych i odrzuconych oraz status ukończenia.

Dodaj testy dla separatora w opisie, cudzysłowu w polu, opisu wielowierszowego, pustego ostatniego pola i nadmiarowej kolumny. Podaj instrukcję uruchomienia.

Krok 3. Zweryfikuj zgodność pól, nie tylko wygląd pliku

Poproś o ponowny odczyt pliku wynikowego i porównanie wartości z zaakceptowanymi rekordami źródłowymi. Zapis CSV może wyglądać inaczej — na przykład część pól otrzyma dodatkowe cudzysłowy — a mimo to zawierać dokładnie te same dane. Kryterium odbioru stanowi zgodność wartości, kolejności kolumn i liczby zaakceptowanych rekordów, a nie identyczny wygląd tekstu w pliku.

Mini-case studies: zapytania do API, generowanie makr i szybkie prototypowanie narzędzia

Te trzy zastosowania rozwiązują różne problemy: API pozwala pobrać informacje z innego systemu, makro wykonuje powtarzalne czynności w używanej aplikacji, a prototyp pomaga sprawdzić pomysł na własne narzędzie. Claude Code może przygotować potrzebny kod, wyjaśnić sposób jego uruchomienia i pomóc poprawić błędy. Nie zastąpi jednak dostępu do systemu, dokumentacji jego API ani aplikacji wymaganej do wykonania makra.

Poniższe przykłady pokazują możliwy przebieg pracy, a nie wyniki rzeczywistych wdrożeń. W każdym przypadku warto zacząć od małego zadania z jednoznacznym kryterium odbioru.

1. Zapytanie do API: sprawdzanie statusów zgłoszeń bez otwierania każdego z osobna

Osoba obsługująca klientów ma listę identyfikatorów zgłoszeń i chce sprawdzić ich aktualny status. Zamiast wyszukiwać je pojedynczo w panelu, może wykorzystać API systemu — o ile udostępnia ono odpowiednią operację odczytu, a jej konto ma wymagane uprawnienia.

Krok 1. Określ zakres odpowiedzi. Na początek wystarczą identyfikator zgłoszenia, status i data ostatniej aktualizacji. Dostarcz Claude Code dokumentację odpowiedniego fragmentu API oraz kilka testowych identyfikatorów. Nie zakładaj, że nazwy pól lub adresy endpointów będą takie same jak w innym systemie.

Krok 2. Zleć przygotowanie minimalnego rozwiązania. Skrypt powinien wyłącznie odczytywać dane i wyświetlać wyniki w terminalu. Integracja dwukierunkowa, harmonogram i rozbudowany raport nie są potrzebne do sprawdzenia, czy pomysł działa.

Przygotuj prosty skrypt sprawdzający statusy zgłoszeń przez API na podstawie dostarczonej dokumentacji.

Najpierw sprawdź, czy dokumentacja zawiera endpoint odczytu zgłoszenia, sposób uwierzytelniania i opis potrzebnych pól. Jeśli czegoś brakuje, zapytaj mnie — nie wymyślaj adresów ani struktury odpowiedzi.

Dane wejściowe: lista identyfikatorów podana przy uruchomieniu.
Wynik: identyfikator, status i data ostatniej aktualizacji, jeśli API ją udostępnia.
Używaj wyłącznie udokumentowanych operacji odczytu. Token pobieraj ze zmiennej środowiskowej; nie umieszczaj go w kodzie ani komunikatach.
Uwzględnij timeout oraz błędy uwierzytelniania, brak zgłoszenia i limit zapytań. Nie stosuj nieograniczonych ponowień.
Dodaj krótką instrukcję uruchomienia. Nie łącz się z API przed moim potwierdzeniem.

Krok 3. Sprawdź kilka różnych odpowiedzi. Po przygotowaniu rozwiązania przetestuj poprawny identyfikator i identyfikator nieistniejący. Pozostałe błędy można najpierw zasymulować, zamiast celowo obciążać usługę lub wywoływać limit zapytań.

Krok 4. Porównaj wynik z panelem systemu. Sprawdź także znaczenie statusów i strefę czasową dat. Kryterium odbioru jest proste: skrypt pokazuje zgodne informacje, a brak danych wyraźnie odróżnia od błędu połączenia. Dopiero wtedy warto zwiększyć liczbę sprawdzanych zgłoszeń.

2. Makro: przygotowanie paczki PDF z wybranych arkuszy Excela

Powtarzalna praca w Excelu nie zawsze dotyczy obliczeń. Czasem polega na wybraniu tych samych zakładek, ustawieniu wydruku i zapisaniu każdej jako PDF. To dobry kandydat na makro VBA, ponieważ automatyzuje czynności wykonywane wewnątrz aplikacji.

Krok 1. Opisz środowisko i oczekiwane pliki. W tym przykładzie chodzi o desktopowy Excel dla Windows. Podaj nazwy zakładek, orientację stron oraz regułę nazywania dokumentów. Ustal też, czy każda zakładka ma trafić do osobnego pliku. Makra VBA nie uruchomisz w Excelu w przeglądarce.

Krok 2. Zamów makro z czytelnym zakończeniem pracy. Komunikat „Gotowe” to za mało: użytkownik powinien wiedzieć, które pliki powstały, a których nie udało się zapisać.

Napisz makro VBA dla desktopowego Excela w Windows. Ma eksportować wskazane arkusze do osobnych plików PDF.

Najpierw zapytaj mnie o nazwy arkuszy i orientację stron. Przy uruchomieniu makro ma pozwolić wybrać folder docelowy.
Ustaw dopasowanie wydruku do jednej strony szerokości, bez wymuszania jednej strony wysokości. Zachowaj istniejące obszary wydruku i przywróć zmienione ustawienia strony po zakończeniu, również w razie błędu.
Nazwa PDF ma zawierać nazwę arkusza i bieżącą datę. Obsłuż znaki niedozwolone w nazwach plików. Nie nadpisuj istniejących dokumentów — dodaj kolejny numer.
Nie zmieniaj wartości komórek ani formuł. Na końcu pokaż listę zapisanych plików i napotkanych błędów.
Podaj instrukcję wstawienia kodu do skoroszytu XLSM i ręcznego uruchomienia. Nie dodawaj automatycznego startu makra.

Krok 3. Uruchom próbę na kopii skoroszytu. Zacznij od dwóch zakładek o różnej szerokości. Claude Code może wygenerować i przeanalizować VBA, ale sprawdzenie układu dokumentów wymaga uruchomienia makra w docelowym Excelu.

Krok 4. Otwórz wygenerowane PDF-y. Oceń kompletność tabel, czytelność tekstu i podział stron. Jeśli wydruk jest zbyt drobny, opisz konkretny problem zamiast prosić ogólnie o „lepsze formatowanie”. Gotowe makro powinno dawać poprawne dokumenty również przy ponownym uruchomieniu, bez nadpisywania poprzedniej paczki.

3. Szybki prototyp: kalkulator obciążenia zespołu

Nie każdy pomysł wymaga od razu wdrożenia aplikacji. Jeśli chcesz sprawdzić, czy prosty kalkulator pomoże planować pracę, wystarczy lokalna strona HTML z formularzem. Taki prototyp służy do weryfikacji sposobu liczenia i wygody obsługi, nie do zarządzania rzeczywistym harmonogramem.

Krok 1. Zapisz założenia obliczeń. Użytkownik podaje liczbę osób, dostępne godziny pracy jednej osoby w tygodniu, liczbę zadań i średni czas zadania w minutach. Dostępne godziny powinny już uwzględniać czas przeznaczony na spotkania i inne obowiązki.

Krok 2. Ogranicz pierwszą wersję do jednego ekranu. Logowanie, baza danych i integracje nie pomogą jeszcze odpowiedzieć na najważniejsze pytanie: czy wynik jest zrozumiały i przydatny?

Zbuduj prototyp kalkulatora tygodniowego obciążenia zespołu jako jeden lokalny plik HTML z osadzonym CSS i JavaScriptem, bez zewnętrznych bibliotek i połączeń sieciowych.

Pola: liczba osób, dostępne godziny na osobę w tygodniu, liczba zadań, średni czas zadania w minutach.
Obliczenia:
- dostępna pojemność w godzinach = liczba osób × godziny na osobę;
- zapotrzebowanie w godzinach = liczba zadań × czas zadania / 60;
- obciążenie procentowe = zapotrzebowanie / dostępna pojemność × 100.
Pokaż także nadwyżkę lub niedobór godzin. Nie pozwalaj na wartości ujemne, a przy zerowej pojemności wyświetl wyjaśnienie zamiast dzielić przez zero. Liczba osób i zadań musi być całkowita.
Dodaj etykiety pól, jednostki i krótkie objaśnienie wyniku. Nie zapisuj danych po odświeżeniu strony.
Wskaż założenia: model nie uwzględnia różnic kompetencji, zależności między zadaniami ani zmienności czasu ich wykonania. Dołącz instrukcję otwarcia pliku w przeglądarce.

Krok 3. Zweryfikuj wynik ręcznie. Dla pięciu osób dostępnych po 30 godzin pojemność wynosi 150 godzin. Dwieście zadań po 45 minut również wymaga 150 godzin, więc kalkulator powinien pokazać obciążenie 100% i zerową rezerwę.

Krok 4. Sprawdź użyteczność z przyszłym użytkownikiem. Poproś go o wpisanie przykładowego scenariusza bez dodatkowych objaśnień. Jeśli myli godziny tygodniowe z dziennymi albo nie rozumie wyniku, popraw najpierw etykiety i opis. Prototyp spełnia swoją rolę wtedy, gdy pozwala ocenić sens narzędzia przed inwestowaniem w jego pełną wersję.

Bezpieczeństwo i zgodność: kryteria, anonimizacja danych, czego nie wolno oraz checklisty przed uruchomieniem kodu

W pracy z Claude Code trzeba ocenić dwa odrębne ryzyka: jakie informacje udostępniamy narzędziu oraz co pozwalamy mu zrobić. Analiza pliku może ujawnić dane objęte tajemnicą przedsiębiorstwa, a uruchomienie wygenerowanego skryptu — nadpisać dokumenty lub zmienić rekordy w systemie. Poprawny wynik nie oznacza jeszcze, że sposób jego uzyskania był bezpieczny i zgodny z zasadami firmy.

Kiedy można działać samodzielnie, a kiedy potrzebna jest akceptacja?

Przed rozpoczęciem zadania oceń poufność danych, zakres dostępu, skutki błędu i możliwość cofnięcia zmian. Praca na syntetycznym zestawie testowym, bez połączenia z systemami firmowymi, ma inny poziom ryzyka niż przetwarzanie danych klientów lub aktualizacja informacji przez API. Im bardziej poufne dane i trudniejsze do odwrócenia działanie, tym większa potrzeba kontroli przez człowieka.

Zadania obejmujące dane osobowe, dokumenty poufne, instalację zależności lub zapis do systemów produkcyjnych powinny przechodzić ścieżkę akceptacji właściwą dla danej organizacji. Może to wymagać udziału właściciela danych, IT, zespołu bezpieczeństwa lub osoby odpowiedzialnej za ochronę danych. Sam dostęp pracownika do dokumentu nie oznacza zgody na przekazanie go zewnętrznemu dostawcy AI.

Nie zakładaj też, że uruchomienie Claude Code na komputerze oznacza przetwarzanie wszystkiego wyłącznie lokalnie. Treści potrzebne do realizacji zadania mogą trafiać do usługi modelu. Przed użyciem danych firmowych trzeba zweryfikować warunki dla konkretnego sposobu korzystania z narzędzia: zasady retencji, wykorzystania danych, dostęp administracyjny oraz — gdy dotyczy — umowę powierzenia i podstawy transferu danych poza EOG. Nie należy przenosić założeń z prywatnego konta na środowisko firmowe ani odwrotnie.

Anonimizacja: usuń możliwość identyfikacji, nie tylko nazwiska

Najbezpieczniejszym materiałem do pierwszego testu są dane syntetyczne, które odtwarzają strukturę pliku i istotne przypadki, ale nie opisują rzeczywistych osób. Jeśli potrzebna jest próbka rzeczywistych danych, ogranicz ją do niezbędnych kolumn i rekordów. Usuń nie tylko nazwiska, adresy i telefony, lecz także identyfikatory, komentarze oraz kombinacje informacji pozwalające rozpoznać osobę, na przykład stanowisko, lokalizację i dokładną datę zdarzenia.

Zamiana nazwiska na oznaczenie „Klient 001” nie musi być anonimizacją. Jeżeli istnieje klucz pozwalający odtworzyć tożsamość albo można ją ustalić na podstawie pozostałych informacji, mamy do czynienia z pseudonimizacją. Dane pseudonimizowane nadal mogą być danymi osobowymi i podlegać RODO.

Sprawdź również miejsca, których nie widać w podstawowym widoku dokumentu: ukryte arkusze i kolumny, komentarze, metadane, nazwy plików oraz dołączone logi. Minimalizacja dotyczy także informacji biznesowych — do testowania obliczeń zwykle nie są potrzebne rzeczywiste marże, stawki ani warunki umów.

Czego nie wolno robić

Nie wklejaj do poleceń haseł, tokenów API, kluczy prywatnych ani innych sekretów. Nie pozwalaj narzędziu odczytywać ich „na wszelki wypadek”. Jeśli zadanie wymaga uwierzytelnienia, użyj mechanizmu zatwierdzonego przez IT i uprawnień ograniczonych do niezbędnego zakresu. Sekret ujawniony w rozmowie, pliku wynikowym lub repozytorium należy potraktować jako potencjalnie przejęty i obsłużyć zgodnie z procedurą incydentową.

Nie obchodź firmowych ograniczeń przez konto prywatne, nie wyłączaj zabezpieczeń tylko po to, by polecenie zadziałało, i nie uruchamiaj niezweryfikowanych zmian bezpośrednio na danych produkcyjnych. Równie ważne jest traktowanie treści plików i odpowiedzi z API jako danych, a nie zaufanych instrukcji. Mogą zawierać próbę nakłonienia narzędzia do ujawnienia informacji lub wykonania niepożądanej operacji.

Checklista przed uruchomieniem kodu

• Zakres działania: wiem, które pliki i systemy zostaną odczytane, zmienione lub usunięte. Samo wyjaśnienie wygenerowane przez model nie zastępuje weryfikacji.
• Środowisko testowe: pracuję na kopii danych, w odizolowanym katalogu lub środowisku testowym, z ograniczonymi uprawnieniami.
• Możliwość wycofania: mam sprawdzoną kopię zapasową albo inną skuteczną metodę przywrócenia poprzedniego stanu.
• Komunikacja zewnętrzna: wiem, czy kod wysyła dane do sieci, pod jakie adresy i czy jest to dozwolone.
• Zależności i polecenia: instalowane pakiety oraz operacje systemowe zostały sprawdzone; niezrozumiałe działania konsultuję z osobą techniczną.
• Próba na małej skali: najpierw wykonuję test na niewielkiej próbce, a jeśli narzędzie to umożliwia — podgląd zmian bez ich zapisywania.
• Kryteria poprawności: mam ustalone kontrole wyniku, na przykład liczbę rekordów, sumy kontrolne lub zgodność wybranych wartości z danymi wejściowymi.

Przed zaakceptowaniem prośby Claude Code o wykonanie operacji przeczytaj jej rzeczywisty zakres. Mechanizm uprawnień jest zabezpieczeniem pomocniczym, nie gwarancją bezpieczeństwa. Jeżeli nie potrafisz ocenić skutków działania, wstrzymaj je i poproś o przegląd techniczny.

Po wykonaniu zadania sprawdź wynik oraz to, czy nie powstały dodatkowe pliki lub logi zawierające dane poufne. Zachowaj ślad zatwierdzenia i wykonanych zmian zgodnie z polityką firmy, a materiały tymczasowe usuń według obowiązujących zasad retencji. Dopiero zweryfikowany rezultat powinien trafić do dalszego wykorzystania biznesowego.

Współpraca z IT: jak pisać wymagania, przekazywać kod do review, testować i wdrażać w firmie

Działający prototyp przygotowany z Claude Code nie jest jeszcze narzędziem gotowym do firmowego wdrożenia. Może poprawnie obsługiwać przykładowy plik, a jednocześnie nie radzić sobie z innym układem danych, przerwanym połączeniem lub ponownym uruchomieniem zadania. Osoba biznesowa określa oczekiwany rezultat, a IT ocenia sposób wykonania, integrację z firmowym środowiskiem i możliwość utrzymania rozwiązania. Taki podział pozwala wykorzystać znajomość procesu bez przenoszenia odpowiedzialności technicznej na użytkownika Claude Code.

Wymagania: opisz problem i warunki sukcesu

Zanim zaczniesz rozwijać prototyp, uzgodnij z IT, czy podobne rozwiązanie już istnieje i kto powinien uczestniczyć w jego ocenie. Jest to szczególnie ważne, gdy narzędzie ma korzystać ze wspólnych systemów, zmieniać dane lub działać cyklicznie. Wczesna konsultacja może oszczędzić pracy nad rozwiązaniem, którego firma nie będzie mogła utrzymywać.

Opis wymagań nie musi być techniczny. Powinien natomiast pozwalać drugiej osobie jednoznacznie ustalić, co oznacza poprawne wykonanie zadania. Zamiast prośby „zautomatyzuj raportowanie” przygotuj krótki opis obejmujący:

• Cel i użytkownika: kto będzie korzystać z narzędzia, jaki problem ono usuwa i po czym poznacie poprawę.
• Wejście i wynik: jakie dane trafiają do procesu, jaki rezultat ma powstać i gdzie użytkownik powinien go znaleźć.
• Reguły oraz wyjątki: jak traktować braki, duplikaty i błędne wartości, kiedy kontynuować pracę, a kiedy ją przerwać.
• Skalę i kryteria odbioru: jak często narzędzie będzie uruchamiane, jaką ilość danych ma obsługiwać i jakie sprawdzalne warunki musi spełnić.

Przykładowe kryterium odbioru może brzmieć: „Każdy wiersz wejściowy musi zostać uwzględniony w wyniku albo wskazany w zestawieniu odrzuceń wraz z przyczyną”. Taki zapis daje podstawę do testu. Sformułowanie „narzędzie ma działać bezbłędnie” jej nie daje. Podczas szkoleń Cognity pogłębiamy te zagadnienia na konkretnych przykładach z pracy uczestników.

Code review: przekaż rozwiązanie razem z kontekstem

Code review, czyli przegląd kodu przez osobę techniczną, służy ocenie sposobu realizacji wymagań. Nie zastępuje potwierdzenia, że same wymagania odpowiadają potrzebom biznesowym. Do przeglądu przekaż konkretną wersję rozwiązania w uzgodnionym z IT miejscu, na przykład w firmowym repozytorium, zamiast przesyłać kolejne, trudne do odróżnienia załączniki.

Dołącz opis celu, instrukcję uruchomienia, wymagane biblioteki, przykładowe dane z oczekiwanym wynikiem oraz znane ograniczenia. Zaznacz również, które elementy powstały z pomocą Claude Code i co zostało faktycznie sprawdzone. Dokumentacja wygenerowana przez AI jest materiałem roboczym — jej zgodność z działaniem narzędzia trzeba zweryfikować. Dla recenzenta ważniejsza od historii rozmowy z modelem jest możliwość odtworzenia wyniku i zrozumienia przyjętych decyzji.

Testowanie: oddziel poprawność techniczną od biznesowej

IT powinno zweryfikować kwestie techniczne, a właściciel procesu — znaczenie wyniku. Poprawnie utworzony plik może przecież zawierać niewłaściwie policzone wartości lub pomijać istotną kategorię danych. Testy odbiorcze warto więc oprzeć na niewielkim zestawie przykładów, dla których oczekiwany rezultat został ustalony niezależnie od kodu.

Sprawdźcie nie tylko typowy przebieg, lecz także brak danych, nieprawidłowy format, większy wolumen i ponowne wykonanie tego samego zadania. Po poprawkach wracajcie do tych samych przypadków testowych. Pozwala to wykryć sytuację, w której usunięcie jednego błędu powoduje inny.

Wdrożenie: ustal właściciela i sposób utrzymania

Pilotaż na ograniczonym zakresie różni się od wdrożenia produkcyjnego: to drugie staje się częścią codziennej pracy i wymaga obsługi również wtedy, gdy coś zawiedzie. Przed uruchomieniem ustalcie, kto zatwierdza wersję, kto odpowiada za proces, kto przyjmuje zgłoszenia oraz jak wrócić do poprzedniego sposobu pracy.

Odbiór powinien dotyczyć konkretnej, przetestowanej wersji. Kolejna zmiana wygenerowana przez Claude Code nie staje się automatycznie zatwierdzona tylko dlatego, że poprzednia działała. W firmie gotowe narzędzie to nie tylko kod, lecz także uzgodnione zasady jego używania, aktualizacji i utrzymania.

Claude vs ChatGPT vs Microsoft Copilot – które AI wybrać do firmy? 15 października 2026

Claude Projects – jak zbudować własne środowisko pracy z dokumentami i wiedzą firmy 13 października 2026