BlogClaude Code

Jak wdrożyć Claude Code w firmie, od pierwszej decyzji po szkolenie zespołu

Wdrażaj Claude Code w tej kolejności: ustal, z jakich kont korzystają programiści i dokąd trafiają ich zapytania, ustaw uprawnienia centralnie, umieść instrukcje zespołu w repozytorium, przeprowadź pilotaż z jednym zespołem i szkol ludzi na ich własnych zadaniach. W Niemczech włącz radę zakładową i inspektora ochrony danych jeszcze przed pilotażem, bo narzędzie może zapisywać, kto z niego korzysta i jak intensywnie. Przy każdym kroku podajemy ustawienia z dokumentacji Anthropic, którymi go realizujesz.

Autor: Zaktualizowano

Co ustalić, zanim pierwszy programista zainstaluje Claude Code

Najpierw ustal dwie rzeczy: na jakie konta logują się programiści i który dostawca otrzymuje ich zapytania. Przewodnik Anthropic dla administratorów wymienia pięciu dostawców, a wybór przesądza o rozliczeniach, logowaniu, warunkach zgodności, które przejmujesz, i o dostępnych funkcjach.

Dokąd mogą trafiać zapytania Claude Code według dokumentacji Anthropic
OpcjaPasuje, gdy
Claude for Teams lub EnterpriseChcesz subskrypcji za stanowisko, bez własnej infrastruktury. Anthropic zaleca to większości organizacji
Claude ConsolePracujesz głównie przez API albo chcesz płacić za zużycie
Amazon BedrockRozliczenia, logowanie i mechanizmy zgodności mają działać przez twoje konto AWS
Google Vertex AI, obecnie Google Cloud's Agent PlatformRozliczenia, logowanie i mechanizmy zgodności mają działać przez twój projekt w Google Cloud
Microsoft FoundryRozliczenia, logowanie i mechanizmy zgodności mają działać przez Azure

Dostawca decyduje też o zakresie funkcji. Między innymi sesje w chmurze, Code Review i Remote Control wymagają konta claude.ai i nie są dostępne przy samych poświadczeniach dostawcy chmury. W Bedrock i Google Cloud przypnij wersje modeli przed wdrożeniem, żeby samodzielnie decydować, kiedy zespół przechodzi na nowy model.

Praca powinna odbywać się wyłącznie na kontach firmowych. W planach konsumenckich Free, Pro i Max Anthropic trenuje modele na danych, gdy użytkownik ma włączone to ustawienie, i dotyczy to także Claude Code. Zarządzane ustawienia forceLoginMethod i forceLoginOrgUUID, które ustawiasz centralnie, ograniczają logowanie do jednej metody albo do twojej organizacji w Anthropic.

Co dzieje się z kodem i promptami

Claude Code działa na komputerze programisty i wysyła prompty oraz odpowiedzi modelu do dostawcy, szyfrowane w transmisji protokołem TLS 1.2 lub nowszym. Dla klientów planów Team i Enterprise oraz API Anthropic deklaruje, że nie trenuje modeli generatywnych na kodzie ani promptach z Claude Code, a dane przechowuje standardowo przez 30 dni. Zero data retention jest dostępne dla kwalifikujących się kont Enterprise, a Anthropic włącza je dla każdej organizacji osobno.

W Amazon Bedrock i Google Cloud o przechowywaniu decydują warunki tych platform. AWS dokumentuje, że dostawcy modeli nie mają dostępu do kont, na których Bedrock uruchamia modele, a więc także do promptów i odpowiedzi klientów. U każdego dostawcy zapisy sesji leżą też na komputerze programisty jawnym tekstem w ~/.claude/projects/, domyślnie przez 30 dni, a cleanupPeriodDays zmienia ten okres.

Które ustawienia i uprawnienia ustawić centralnie

Wszystko, co ma obowiązywać na każdym komputerze, umieść w zarządzanych ustawieniach (managed settings), bo ustawienia użytkownika i projektu nie mogą ich nadpisać, poza kilkoma wyjątkami związanymi z bezpieczeństwem. Organizacja w planie Teams lub Enterprise ustawia je w konsoli administracyjnej Claude. U każdego dostawcy system zarządzania urządzeniami może je rozesłać jako profil konfiguracyjny macOS albo politykę rejestru Windows, albo jako plik managed-settings.json, w Linuksie w /etc/claude-code/.

Minimalny managed-settings.json z dokumentacji Anthropic
{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "allowManagedPermissionRulesOnly": true
}

Ten plik blokuje odczyt .env i katalogu z sekretami, wyłącza tryb pomijający pytania o uprawnienia i sprawia, że zarządzane ustawienia są jedynym źródłem reguł uprawnień. Reguły są sprawdzane w kolejności deny, ask, allow, a reguły deny z dowolnego poziomu nie da się znieść na innym. Zdecyduj też o tych punktach:

  • Sieć i system plików: reguła Bash dopasowuje tekst komendy i nie jest granicą bezpieczeństwa, bo Bash(curl *) nie zatrzyma /usr/bin/curl. Skuteczne ograniczenia daje sandbox z listą dozwolonych domen.
  • Serwery MCP, które łączą Claude Code z zewnętrznymi narzędziami, na przykład z systemem zgłoszeń: allowedMcpServers i deniedMcpServers określają, które serwery programiści mogą dodawać.
  • Hooki i modele: hook to komenda powłoki, którą Claude Code uruchamia w ustalonym momencie, a allowManagedHooksOnly ogranicza, które hooki się uruchamiają. availableModels ogranicza modele, które programiści mogą wybrać.

Po wdrożeniu poproś programistę o uruchomienie /status. Jeśli w wierszu „Setting sources” widać „Enterprise managed settings”, polityka obowiązuje.

Co powinno trafić do repozytorium

Commituj wszystko, co ma być wspólne dla całego zespołu, żeby przechodziło przez review tak jak kod.

  • CLAUDE.md w katalogu głównym zawiera instrukcje zespołu, na przykład komendy builda i testów oraz konwencje. Komenda /init przygotowuje szkic na podstawie kodu. Claude traktuje ten plik jako kontekst i go nie egzekwuje, a Anthropic radzi trzymać się poniżej 200 linii na plik.
  • .claude/settings.json zawiera reguły uprawnień i hooki projektu, na przykład formatter uruchamiany po każdej edycji pliku.
  • .claude/skills/ zawiera procedury, które zespół wywołuje jako komendy z ukośnikiem. Każdy skill to plik SKILL.md, którego treść wczytuje się dopiero przy użyciu.
  • .mcp.json wymienia serwery MCP projektu. Claude Code prosi każdego programistę o zgodę, zanim użyje serwerów z tego pliku.

Osobiste preferencje zostają poza repozytorium, w CLAUDE.local.md. Istniejący AGENTS.md dla innych agentów kodujących zostaje, a CLAUDE.md importuje go linią @AGENTS.md, bo Claude Code czyta CLAUDE.md. Kto odpowiada za te pliki, opisuje nasz poradnik o instrukcjach Claude Code w zespole.

Jak przeprowadzić pilotaż z jednym zespołem i co mierzyć

Zacznij od jednego zespołu, którego repozytorium ma działające testy i CI, i pozwól mu używać Claude Code przy zwykłych zadaniach. Rada Anthropic na początek jest skromna: zacząć od pytań o kod i mniejszych poprawek błędów, a najpierw prosić o plan. Zapisz z góry, przy jakim wyniku rozszerzysz pilotaż, a przy jakim go przerwiesz.

Mierz pracę na poziomie zespołu i porównuj z tymi samymi liczbami z miesięcy przed pilotażem:

  • Czas od pierwszego commita do merge'a dla porównywalnych zadań
  • Uwagi z review i poprawki na jeden zmergowany pull request
  • Nieudane przebiegi CI i wycofane zmiany
  • Wydatki na jeden zmergowany pull request, z eksportu użycia od dostawcy

Dashboard analityczny w planach Teams i Enterprise pokazuje zaakceptowane linie kodu, odsetek przyjętych propozycji i dziennie aktywnych użytkowników. To miary użycia, które nic nie mówią o jakości zmiany.

Dlaczego szkolenie powinno odbywać się na zadaniach zespołu

Szkol na własnym repozytorium i backlogu zespołu, bo pytania, które decydują o wynikach, pojawiają się dopiero tam: które zadanie oddać i ile kontekstu potrzebuje ticket. Podstawy pokrywają bezpłatne kursy Anthropic do samodzielnej nauki, Claude Code 101 i Claude Code in Action.

Szkolenie na prawdziwych zadaniach powinno objąć te punkty:

  • Tryb planowania, w którym Claude czyta kod i proponuje plan bez edycji plików
  • Czytanie diffa i wyniku testów przed przyjęciem zmiany
  • Pytania o uprawnienia i to, które zgody powinny trafić do wspólnego pliku ustawień
  • Kiedy dopisać linię do CLAUDE.md, na przykład gdy Claude drugi raz popełnia ten sam błąd
  • Czego nie wpisywać do promptu, zgodnie z twoją własną klasyfikacją danych

O co zapytają rada zakładowa i inspektor ochrony danych

Rada zakładowa zapyta, co narzędzie może zapisywać o poszczególnych programistach. § 87 ust. 1 pkt 6 niemieckiej ustawy o ustroju zakładów pracy (BetrVG) daje jej prawo współdecydowania przy urządzeniach technicznych przeznaczonych do nadzorowania zachowania lub wydajności pracowników, a Federalny Sąd Pracy uznał 8 marca 2022 r. (1 ABR 20/21), że wystarczy, by urządzenie obiektywnie nadawało się do zapisywania takich informacji. Jak dotyczy to twojej firmy, ustal z prawnikiem od prawa pracy. To nie jest porada prawna.

Eksport danych o użyciu do własnego monitoringu przez OpenTelemetry jest wyłączony, dopóki nie zostanie ustawiona zmienna CLAUDE_CODE_ENABLE_TELEMETRY, a administratorzy mogą ustawić ją wszystkim w zarządzanych ustawieniach. Po włączeniu metryki obejmują sesje, zmienione linie kodu, commity, pull requesty, koszty i czas aktywności. Zawierają identyfikator konta i adres e-mail użytkownika, dopóki ich nie wyłączysz albo nie odfiltrujesz w kolektorze. Treść promptów nie jest domyślnie eksportowana. W planach Teams i Enterprise administratorzy i właściciele widzą też w dashboardzie analitycznym ranking poszczególnych użytkowników.

Porozumienie zakładowe może więc określić, czy eksport jest włączony, które atrybuty są usuwane przed zapisem i kto ma rolę administratora. Nasz przewodnik o logach a radzie zakładowej omawia te pola po kolei.

Inspektor ochrony danych zapyta, gdzie dane są przetwarzane, jak długo są przechowywane i na jakiej podstawie umownej, a odpowiedzi wynikają z opisanej wyżej decyzji o dostawcy. Zgodnie z art. 28 ust. 3 RODO przetwarzanie przez dostawcę w twoim imieniu wymaga umowy, a art. 35 wymaga oceny skutków dla ochrony danych, gdy przetwarzanie może powodować wysokie ryzyko. Czy tak jest, ustal ze swoim inspektorem ochrony danych.

Kiedy pomoc z zewnątrz ma sens

Zespół, który ma własną grupę platformową i czas na dokumentację, zrobi większość tego sam. Pomoc z zewnątrz opłaca się w takich sytuacjach:

  • Nikt nie ma czasu, żeby obok zwykłej pracy odpowiadać za ustawienia, przygotowanie repozytorium i pilotaż
  • Dział bezpieczeństwa, inspektor ochrony danych albo rada zakładowa mają otwarte pytania, a projekt czeka na odpowiedzi
  • Jeden zespół już używa Claude Code, a jego sposobu pracy nie udaje się przenieść na kolejny zespół

W ramach konsultingu Claude Code dopasowujemy Claude Code do twojego kodu, uprawnień i procesu review oraz prowadzimy pilotaż z jednym zespołem. Na szkoleniu z Claude Code programiści ćwiczą na zadaniach z własnego backlogu. Początek jest w obu przypadkach ten sam: porozmawiaj z inżynierem, to bezpłatna 30-minutowa rozmowa, która nie wymaga dostępu do twoich systemów ani danych. Potem uzgadniamy na piśmie stałą cenę za każdy krok.

Pytania

Jaki plan Claude jest potrzebny firmie do Claude Code?

Większości organizacji Anthropic zaleca Claude for Teams albo Enterprise, bo stanowiska, logowanie i centralne ustawienia są tam zarządzane w jednym miejscu. Kto woli płacić za zużycie, korzysta z Claude Console albo z dostawcy chmury. Ceny się zmieniają, więc nasz poradnik o kosztach wdrożenia agentów kodujących pokazuje sposób liczenia zamiast cennika.

Czy rada zakładowa musi zgodzić się na wdrożenie Claude Code?

To pytanie prawne do prawnika od niemieckiego prawa pracy. Technicznie Claude Code może rejestrować dla każdego użytkownika sesje, linie kodu, commity, koszty i czas aktywności, a Federalny Sąd Pracy bada, czy system obiektywnie nadaje się do nadzoru. Dlatego włącz radę zakładową przed pilotażem. To nie jest porada prawna.

Ile kosztuje konsulting Claude Code?

Po bezpłatnej 30-minutowej rozmowie uzgadniamy na piśmie stałą cenę za każdy krok. Zakres zależy od liczby zespołów i repozytoriów oraz od tego, czego potrzebują dział bezpieczeństwa, inspektor ochrony danych i rada zakładowa. Koszty licencji i użycia Claude Code są osobne i płacisz je Anthropic albo dostawcy chmury.

Czy potrzebujemy szkolenia z Claude Code, czy wystarczy dokumentacja?

Do obsługi narzędzia dokumentacja i bezpłatne kursy Anthropic często wystarczą. Szkolenie opłaca się przy tym, czego tam być nie może: jak wydzielać zadania z twojego backlogu i jak sprawdzać plany oraz diffy w twoim kodzie.

Po czym poznać eksperta od Claude Code?

Poproś o pokazanie pracy: pliku z zarządzanymi ustawieniami z uzasadnieniem każdej reguły i liczb z pilotażu na poziomie zespołu. Produkt często się zmienia, więc taka osoba powinna umieć poprzeć każde stwierdzenie aktualną dokumentacją Anthropic.

Porozmawiaj z inżynierem

Przyjdź z jednym zadaniem, które chcesz usprawnić. Rozmowa trwa 30 minut i nie wymaga dostępu do twoich systemów ani danych.

Rezerwacja odbywa się w Kalendarzu Google.

Mickey Graf

Gdy umawiasz rozmowę, rozmawiasz z Mickeyem Grafem

Założył Cloudsail i od 2017 roku wdraża uczenie maszynowe na produkcji, między innymi jako inżynier AI w trivago i SAP. Rozmowa może być po polsku, niemiecku albo angielsku.

Ocena 4,9 na 5 w serwisie Clutch

Wolisz najpierw napisać? Zostaw e-mail i kilka zdań. Mickey sam czyta każdą wiadomość i odpowiada e-mailem z propozycją terminów.

Przycisk przygotowuje e-mail w twoim własnym programie pocztowym, a wysyłasz go samodzielnie. Polityka prywatności (wersja robocza)