Claude Code w firmie: wdrożenie w zespole programistów krok po kroku
Claude Code to agent programistyczny Anthropic, który czyta repozytorium, zmienia pliki i uruchamia polecenia. Jednej osobie przyspiesza pracę, a w zespole bez wspólnych ustawień każdy pracuje z nim inaczej. Wdrożenie to wspólne zasady zapisane w repozytorium.
Autor: Szymon Łakomy. Aktualizacja:
Gdzie działa Claude Code: terminal, IDE czy aplikacja?
Claude Code działa w terminalu, w rozszerzeniach do VS Code i JetBrains, w aplikacji Claude na komputerze oraz w sesjach w chmurze. Wersje uruchamiane na komputerze czytają te same pliki ustawień, więc konfigurację robię raz, w repozytorium. Instalację i położenie plików ustawień w systemie Windows opisuję osobno na stronie Claude Code na Windows.
Sam pracuję z Claude Code na co dzień, także przy tym serwisie, dlatego opisuję ustawienia, które sprawdziły się w praktyce, a nie listę wszystkich opcji z dokumentacji. Zespołom, które wybierają między Claude Code a Codex od OpenAI, pomaga porównanie Claude Code czy Codex.
Co ustawiam w repozytorium
Wspólna konfiguracja opiera się na pięciu miejscach: CLAUDE.md, ustawieniach zespołu i ustawieniach lokalnych, katalogu skilli oraz ustawieniach zarządzanych przez organizację.
| Plik | Kogo dotyczy | Do czego służy |
|---|---|---|
| CLAUDE.md | cały zespół, w repozytorium | polecenia do budowania i testów, układ projektu, zasady, których nie widać w kodzie |
| .claude/settings.json | cały zespół, w repozytorium | wspólne uprawnienia, hooki, pluginy i zmienne środowiskowe projektu |
| .claude/settings.local.json | jeden programista, poza gitem | osobiste wyjątki i testowanie ustawień przed udostępnieniem |
| .claude/skills/ | cały zespół, w repozytorium | procedury zespołu, na przykład jak dodać moduł albo przygotować wydanie |
| ustawienia zarządzane | wszyscy w organizacji | polityka firmy, której pojedynczy programista nie nadpisze |
Na podstawie dokumentacji Claude Code, stan na listopad 2026.
CLAUDE.md: krótko i o tym, czego nie widać w kodzie
CLAUDE.md to instrukcja, którą Claude czyta na początku każdej sesji. Wpisuję tam polecenia do uruchomienia projektu i testów, mapę katalogów i zasady, których złamanie kosztuje najwięcej: gdzie leżą ceny, czego nie wolno wstawiać do kodu przeglądarki, jak nazywamy migracje. Im krótszy i konkretniejszy plik, tym lepiej Claude go stosuje. Układ pliku, importy i typowe błędy opisuję na stronie jak napisać CLAUDE.md.
Jak zabezpieczyć Claude Code w zespole?
Claude Code zabezpieczam kilkoma warstwami naraz, bo żadna z nich nie wystarcza sama:
- Reguły allow, ask i deny. Testy i linter mogą działać bez pytania, wypychanie zmian wymaga zgody, a odczyt plików .env jest zablokowany.
- Hooki. Krótki skrypt uruchamiany przed działaniem agenta albo po nim: formatuje kod po zmianie, blokuje polecenie spoza listy, zapisuje dziennik. Przykłady i konfigurację zebrałem na stronie hooki w Claude Code.
- Sekrety poza repozytorium. Klucze trafiają do sejfu albo zmiennych środowiskowych, nigdy do CLAUDE.md ani do historii rozmowy.
- Treści z zewnątrz. Strona internetowa albo zgłoszenie od klienta mogą zawierać ukryte polecenia. Ryzyko opisuję na stronie prompt injection.
- Przegląd kodu. Zmiana od agenta przechodzi ten sam przegląd i te same testy co zmiana od człowieka. Kod, którego nikt nie przeczytał, kończy jak w poradniku naprawa aplikacji napisanej przez AI.
Jak zespół pracuje z agentem na co dzień
Na co dzień zespół pracuje z agentem w małych, sprawdzalnych krokach, a o końcu zadania decydują testy:
- Najpierw plan. Przy większej zmianie Claude opisuje plan, a programista go poprawia, zanim powstanie kod.
- Małe kroki. Jedna zmiana, jeden zestaw testów, jeden commit. Długie sesje bez sprawdzania wyników kończą się trudnym przeglądem.
- Testy jako kryterium. Agent uruchamia testy sam, a zadanie jest skończone dopiero wtedy, gdy przechodzą.
- Wiedza do repozytorium. Gdy Claude dwa razy popełni ten sam błąd, zasada trafia do CLAUDE.md albo do skilla, a nie do pamięci jednej osoby. Jak zapisywać takie procedury, opisuję na stronie Skills w Claude dla firmy.
W jakich planach jest Claude Code i od czego zależy koszt?
Claude Code jest dostępny w planach Team i Enterprise, a także z rozliczeniem za użycie przez API. Który wariant wychodzi taniej, zależy od tego, ile osób pracuje z agentem codziennie. Przy rozliczeniu przez API pomaga kalkulator kosztów API AI. Moją pracę przy konfiguracji i szkoleniu rozliczam według stawki 150 do 200 zł netto za godzinę albo podaję cenę za cały zakres po rozmowie.
Źródła
Opis opieram na poniższych źródłach. Przepisy, dokumentacja producentów i warunki usług się zmieniają, więc szczegóły warto sprawdzić u źródła:
- Claude Code overview (Anthropic)
- How Claude remembers your project (CLAUDE.md) (Anthropic)
- Settings files and precedence (Anthropic)
- Hooks reference (Anthropic)
- Security (Anthropic)
Najczęstsze pytania
Czy Claude Code ma dostęp do całego komputera programisty?
Zależy od trybu uprawnień. W trybie ręcznym Claude Code pyta przed edycją plików i uruchomieniem poleceń, a w trybie automatycznym działania ocenia osobny model, który blokuje te uznane za niebezpieczne. W obu trybach obowiązują reguły ask i deny, a zakres zawężam też piaskownicą dla poleceń, hookami i ustawieniami zarządzanymi, bo firma może na przykład wyłączyć tryb automatyczny.
Czy Anthropic trenuje modele na kodzie z Claude Code?
W planach Team i Enterprise dane według strony cennika Anthropic domyślnie nie służą do trenowania modeli. Przy rozliczeniu przez API obowiązują warunki handlowe Anthropic. Przed wdrożeniem sprawdzam je dla wybranego wariantu.
Czy Claude Code nadaje się do starego, dużego projektu?
Tak, często właśnie tam oszczędza najwięcej czasu, bo szybko czyta kod, którego nikt nie pamięta. Warunkiem są testy i dobry CLAUDE.md z opisem pułapek projektu. Gdy testów brakuje, zaczynam od nich, a dopiero potem od większych zmian.
Jak wygląda szkolenie z Claude Code dla programistów?
Szkolenie prowadzę na repozytorium firmy: przygotowujemy CLAUDE.md, ustawienia i pierwsze skille, a potem każdy wykonuje zadanie ze swojego backlogu. Zakres i cenę ustalam po rozmowie.
Powiązane strony
Chcesz wdrożyć Claude Code w swoim zespole?
Napisz, ilu programistów ma pracować z agentem i w jakim stosie. Zaproponuję konfigurację repozytorium i plan szkolenia.