Claude Cowork i GitHub - najważniejsze rozróżnienie na starcie
Są trzy różne sposoby, w jakie Claude dotyka repozytorium GitHub. Większość nieporozumień bierze się z ich mylenia. Zgodnie z pomocą Anthropic pierwszy to konektor GitHub w oknie czatu, który tylko czyta wybrane pliki. Drugi to Claude Cowork, który zgodnie z dokumentacją Anthropic wykonuje na plikach wieloetapowe zadania agentowe. Zgodnie z tą samą dokumentacją trzeci to Claude Code w terminalu, jedyny z pełnym dostępem do gita, a więc jedyny, który commituje i otwiera pull requesty.
Zgodnie z pomocą Anthropic konektor synchronizuje wyłącznie nazwy i zawartość plików z jednej gałęzi. To jedno zdanie z dokumentacji tłumaczy większość rozczarowań: konektor świetnie nadaje się do zrozumienia i opisania kodu, ale zmian z powrotem do repozytorium nie zapisze. Jak działa protokół, który podpina narzędzia do Claude, tłumaczę we wpisie Co to jest MCP.
Co konektor GitHub realnie pobiera, a czego nie
Konektor synchronizuje wyłącznie nazwy i zawartość plików z jednej wybranej gałęzi. Zgodnie z pomocą Anthropic nie pobiera historii commitów, pull requestów ani innych metadanych. To najważniejszy fakt, który zmienia sposób formułowania poleceń.
Konsekwencje są bardzo praktyczne:
- Nie zapytasz “co zmienił ostatni pull request” - konektor nie zna PR-ów.
- Nie zapytasz “kto edytował ten plik” - nie ma historii commitów.
- Zapytasz za to o cokolwiek, co da się wyczytać z aktualnej treści plików - architekturę, zależności, potencjalne błędy.
Innymi słowy, Claude widzi zdjęcie kodu, a nie film z jego historii. Potrzebujesz filmu? Sięgasz po Claude Code.
Warto znać jeszcze jedno zachowanie na wypadek zmian w uprawnieniach. Zgodnie z pomocą Anthropic po utracie dostępu do repozytorium jego zawartość znika z projektu, w którym było podpięte, ale historia rozmowy zostaje nienaruszona.
Jak podpiąć repozytorium do czatu i do projektu
Repozytorium dodajesz na dwa sposoby, zależnie od tego, czy pracujesz nad nim raz, czy stale. W praktyce wybierasz między jednorazowym wrzutem a trwałą wiedzą projektu.
Zgodnie z pomocą Anthropic do jednorazowego pytania służy czat. Klikasz “+” w lewym dolnym rogu, wybierasz “Dodaj z GitHub” i wskazujesz pliki w przeglądarce plików. Treść trafia do kontekstu dopiero przy wysłaniu wiadomości.
Zgodnie z tą samą pomocą do dłuższej pracy nad jednym repozytorium służy projekt. W sekcji wiedzy projektu klikasz “+”, wybierasz “GitHub”, wyszukujesz repozytorium albo wklejasz jego adres, a potem korzystasz z ikony synchronizacji oraz z “Konfiguruj pliki”. Projekt trzyma repo jako stałą wiedzę, więc nie wgrywasz go od nowa przy każdej rozmowie. Cały ekosystem połączeń opisuję we wpisie Integracje Claude Cowork.
Okno kontekstu - dlaczego duże repo trzeba przyciąć
Wiele repozytoriów zmieścisz w jednym projekcie, ale wszystkie razem muszą wejść w okno kontekstu. Zgodnie z pomocą Anthropic dodanie kilku repozytoriów jest dozwolone właśnie pod tym warunkiem. Wrzucisz cały monorepo z zależnościami i Claude spali kontekst na plikach, które nic nie wnoszą.
Anthropic zaleca w dobrych praktykach zaczynać od małego podzbioru kodu i dobierać pliki przez “Konfiguruj pliki” strategicznie, żeby zmieścić się w limitach tokenów. Dobra reguła jest prosta:
- Zaznacz katalog źródłowy, na przykład
src/, oraz kluczowe pliki konfiguracyjne. - Wyklucz
node_modules/, katalogi buildów, pliki lock i wygenerowane artefakty. - Dodawaj kilka repozytoriów do jednego projektu tylko wtedy, gdy realnie pracujesz na styku serwisów, na przykład frontend plus backend plus repo dokumentacji.
Im czystszy zestaw plików, tym trafniejsze odpowiedzi. Zbędne pliki zabierają miejsce i psują jakość.
Pułapka nieświeżej synchronizacji
Repozytorium nie aktualizuje się samo, więc Claude pracuje na stanie z ostatniej synchronizacji. To najczęstsze źródło odpowiedzi, które nie zgadzają się z kodem.
Zgodnie z pomocą Anthropic przycisk “Synchronizuj teraz” pobiera najnowsze zmiany i odświeża wszystkie wcześniej wybrane pliki oraz katalogi. Anthropic zaleca odświeżanie przed rozpoczęciem nowej analizy i po większych zmianach w repozytorium.
Prywatne repo i blokada SSO - najczęstszy problem
Repozytorium prywatne bywa “połączone”, a mimo to niewidoczne na liście. To pułapka, która potrafi kosztować godziny szukania błędu nie tam, gdzie trzeba.
Zacznij od diagnozy, bo przyczyny są dwie. Zgodnie z pomocą Anthropic brak dostępu do repozytorium mimo poprawnego adresu najczęściej oznacza repozytorium prywatne, do którego trzeba nadać uprawnienia w aplikacji GitHub albo poprosić o nie administratora organizacji.
Druga przyczyna dotyczy organizacji z logowaniem jednokrotnym. Zgodnie z pomocą Anthropic, gdy organizacja wymaga SSO, każdy użytkownik musi osobno autoryzować aplikację Claude dla tej organizacji. Do tego czasu GitHub po prostu odfiltrowuje jej prywatne repozytoria z Twojego widoku, choć samo połączenie działa poprawnie.
Naprawa wygląda tak:
- Wejdź na github.com w ustawienia autoryzowanych aplikacji.
- Otwórz wpis “Claude”.
- W sekcji dostępu do organizacji kliknij “Grant” przy właściwej organizacji.
- Jeśli zamiast “Grant” widzisz “Request”, nie masz uprawnień i musi to zatwierdzić administrator GitHuba w politykach aplikacji OAuth.
Zapamiętaj jedną rzecz, bo oszczędza mnóstwo czasu. Zgodnie z pomocą Anthropic rozłączenie i ponowne połączenie GitHuba tego nie naprawia, bo świeże połączenie nie autoryzuje automatycznie organizacji wymagających SSO. W organizacjach korzystających z zarządzanych kont przedsiębiorstwa dochodzi jeszcze zatwierdzenie aplikacji na poziomie całego przedsiębiorstwa.
Co realnie zlecisz Claude na repozytorium
Zgodnie z pomocą Anthropic konektor ma dawać kontekst do zadań programistycznych. Sprawdza się więc tam, gdzie czas zabiera czytanie kodu, a nie zapis do repozytorium.
Przykład 1 - wygenerowanie README. Po podpięciu repo poproś wprost: “Przeanalizuj to repozytorium i napisz kompletny README - opis projektu, wymagania, instalację krok po kroku, przykłady użycia i sekcję o API. Zachowaj styl istniejącej dokumentacji.” Claude zwróci gotowy tekst w oknie, ale go nie zapisze do repo. Plik dokładasz sam albo robisz to przez Claude Code.
Przykład 2 - onboarding do nieznanego projektu. “Wyjaśnij architekturę tego projektu: jakie są główne moduły, jak przepływają między nimi dane i od którego pliku zacząć czytanie, żeby zrozumieć logikę logowania.” Pamiętaj o granicy. Nie dodałeś katalogu z logowaniem, to Claude go nie zna, bo widzi wyłącznie wybrane pliki.
Przykład 3 - przygotowanie do przeglądu kodu. “Przejrzyj pliki w katalogu src/payments/ i wypisz potencjalne błędy, antywzorce oraz miejsca bez obsługi wyjątków. Uporządkuj od najpoważniejszego.” Świetne jako pierwsze podejście przed przeglądem kodu.
Ostatni punkt nie jest kurtuazją. Zgodnie z dobrymi praktykami Anthropic wnioski Claude traktuje się jako punkt wyjścia do dalszej analizy z zespołem, a jego pracę trzeba przejrzeć.
Konektor, Claude Cowork czy Claude Code - tabela decyzyjna
Wybór narzędzia zależy od jednego pytania: czy Claude ma tylko czytać kod, czy zapisać zmiany. Poniższa tabela porządkuje, co potrafi każda droga.
| Sposób | Czyta kod | Widzi historię i PR-y | Zapisuje do repo | Do czego |
|---|---|---|---|---|
| Konektor w czacie | tak, wybrane pliki | nie | nie | szybkie pytanie o kod |
| Konektor w projekcie | tak, z synchronizacją | nie | nie | trwała praca nad jednym repo |
| Claude Code w terminalu | tak, cały projekt | tak | tak, commit i PR | pełny cykl developerski |
Wniosek jest czytelny. Do zrozumienia i opisania kodu w zupełności wystarczy konektor. Zgodnie z pomocą Anthropic dopiero Claude Code pracuje bezpośrednio na maszynie, więc to on domyka przepływ kończący się commitem albo pull requestem. Jak spiąć oba w jeden przepływ, opisuję we wpisie Claude Cowork i Claude Code, a jego instalację w poradniku Jak zainstalować Claude Code.
Najczęstsze pułapki w jednym miejscu
Większość problemów z konektorem GitHub sprowadza się do kilku powtarzalnych przyczyn. Zanim zaczniesz szukać egzotycznych rozwiązań, przejdź tę listę.
- Claude odpowiada na starym kodzie - nie zsynchronizowałeś repo po zmianach.
- Claude nie widzi pliku - nie mieści się w oknie kontekstu albo jest odznaczony w “Konfiguruj pliki”.
- Prośba o różnice z ostatniego PR - niemożliwa, konektor nie pobiera historii ani pull requestów.
- Prośba o commit poprawki - konektor tego nie zrobi, przełącz się na Claude Code.
- Prywatny kod firmowy w chmurze - jeśli polityka firmy tego nie dopuszcza, decyzję o narzędziu podejmij z działem bezpieczeństwa.
Podsumowanie
Konektor GitHub w Claude to potężne narzędzie do czytania kodu, pod warunkiem że rozumiesz jego granice. Czyta wybrane pliki z jednej gałęzi, nie zna historii ani PR-ów, nie zapisuje zmian i pracuje na stanie z ostatniej synchronizacji. Do zrozumienia projektu, dokumentacji i przeglądu wystarcza z zapasem. Kiedy przepływ ma się skończyć commitem albo pull requestem, sięgasz po Claude Code w terminalu. Dwa narzędzia, jeden silnik, jasny podział pracy.
Powtarzalne przepływy między repozytorium a resztą narzędzi da się ustawić raz i zapomnieć. Tak buduję automatyzację marketingu.
