Korporacyjna kontrola kosztów

Korporacyjna kontrola kosztów obejmuje śledzenie i ograniczanie wydatków na Claude Code: widoczność per sesja i per zespół przez /cost, /stats, /context i metryki OpenTelemetry, twarde barierki dla automatyzacji (--max-budget-usd, --max-turns) oraz routing modeli rezerwujący Opusa 5 dla trudnej pracy, a codzienne zadania kierujący do Sonneta 5 i Haiku 4.5. Koszt rośnie wraz z rozmiarem kontekstu i długością rozmowy.

Rachunek zespołu za API Claude Code potroił się w tym miesiącu, finanse chcą twardego limitu do piątku, a nikt nie potrafi powiedzieć, które projekty czy osoby generują ten koszt. Do tego bezpieczeństwo prosi o logi audytowe. Odruch podpowiada, żeby zbudować własny gateway mierzący każde żądanie — tyle że Claude Code ma potrzebną widoczność i barierki w standardzie.

Bez telemetrii to zgadywanie. Z telemetrią jeden dashboard odpowiada na wszystkie pytania finansów, inżynierii i bezpieczeństwa.

Co daje kontrola kosztów w skali zespołu

• Podgląd zużycia tokenów per sesja i per zespół przez /cost, /stats, /context i status line — bez pisania własnej telemetrii
• Eksport OpenTelemetry, który wpycha claude_code.cost.usage i claude_code.token.usage do dashboardu w podziale na zespół i model, plus pełny katalog metryk i zdarzeń do budowy paneli
• Twarde barierki budżetowe dla automatyzacji: --max-budget-usd, --max-turns i model: haiku na poziomie subagenta
• Politykę routingu modeli, która rezerwuje Opusa 5 dla pracy faktycznie tego wymagającej, a codzienne zadania spycha na Sonneta 5 i Haiku 4.5
• Wytyczne do limitów przepustowości skalujące się z wielkością zespołu
• Prompty copy-paste do audytu rozdętej sesji, postawienia eksportera OTel i spisania polityki schodzenia na tańszy model

Gdzie naprawdę uciekają pieniądze

Koszt Claude Code skaluje się z rozmiarem kontekstu i długością rozmowy. Każda wiadomość wysyła od nowa prompt systemowy, twój CLAUDE.md, definicje narzędzi MCP i całą dotychczasową rozmowę.

Trzy największe i najłatwiejsze do opanowania czynniki:

• Nieświeży kontekst — pliki i rozmowa z poprzedniego zadania, których nigdy nie wyczyściłeś
• Definicje narzędzi MCP — każdy podpięty serwer dokłada do kontekstu schematy narzędzi, nawet gdy nic nie robi
• Wybór modelu — Opus 5 do formatowania i poprawek lintera, które Haiku 4.5 załatwia za ułamek ceny

Ile typowo kosztuje jeden deweloper

Punkt odniesienia opublikowany przez Anthropic, przydatny do porównania z własnym dashboardem:

Metryka	Wartość
Średni koszt na dewelopera dziennie	$6
90. percentyl kosztu dziennego	$12
Średnia miesięczna (Sonnet)	$100-200/dewelopera
Średnia miesięczna (dużo Opusa)	$300-500/dewelopera

Automatyzacja, długie sesje i przerośnięty kontekst przebijają te liczby błyskawicznie — dlatego barierki opisane niżej znaczą więcej niż same średnie.

Zobacz wydatki, zanim cokolwiek ograniczysz

Nie da się zarządzać tym, czego się nie widzi, a Claude Code pokazuje zużycie na czterech poziomach.

1. Sprawdź bieżącą sesję. Wpisz /cost w REPL-u, żeby zobaczyć zużycie tokenów i koszt API tej sesji (użytkownicy API), albo /stats dla wzorców zużycia na Max/Pro:

   Total cost:            $0.55
   Total duration (API):  6m 19.7s
   Total duration (wall): 6h 33m 10.2s
   Total code changes:    42 lines added, 18 lines removed

2. Zobacz, co zjada kontekst. /context rozbija dokładnie to, co zajmuje okno — prompt systemowy, CLAUDE.md, definicje narzędzi MCP i historię rozmowy. Tak się znajduje serwer MCP, którego zapomniałeś wyłączyć.

3. Trzymaj zużycie stale na oku. Skonfiguruj status line tak, by pokazywał zajętość okna kontekstu, a presję tokenów zobaczysz przy każdej wiadomości, zamiast odkrywać ją przy fakturze.

4. Zsumuj to dla całego zespołu. Dla workspace’ów API ustaw limity wydatków workspace’u i czytaj raporty kosztów i zużycia w konsoli Anthropic. Workspace “Claude Code” powstaje automatycznie przy pierwszym uwierzytelnieniu i zbiera śledzenie z całej organizacji.

Notatka

Rozliczenie abonamentowe i API to dwa różne światy. Abonenci Claude Max i Pro mają zużycie wliczone w subskrypcję, więc kwoty z /cost nie są twoim rachunkiem — wzorce zużycia obejrzysz przez /stats. Komenda /cost jest dla użytkowników klucza API (konsoli), gdzie zużycie tokenów przekłada się wprost na faktury.

Uwaga

Na Bedrocku, Vertexie i Foundry Claude Code nie odsyła metryk kosztowych do Anthropic — raporty w konsoli będą puste. Przy takich wdrożeniach śledź wydatki przez rozliczenia dostawcy chmury albo przez gateway w rodzaju LiteLLM, który liczy wydatki per klucz wirtualny.

Dashboardy dla całej organizacji na OpenTelemetry

/cost działa w obrębie sesji. Po widok na poziomie finansów, obejmujący wszystkich deweloperów, wyeksportuj metryki OpenTelemetry Claude Code do swojego stacku obserwowalności.

Włączenie telemetrii

Cała konfiguracja to zmienne środowiskowe — bez pisania kodu:

# Turn on telemetry and pick your exporters
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp        # otlp, prometheus, or console
export OTEL_LOGS_EXPORTER=otlp

# Point at your OTLP collector
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://collector.company.com:4317
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer ${OTEL_TOKEN}"

Żeby przypisać wydatki do zespołów, oznacz każdą sesję atrybutem zasobu:

export OTEL_RESOURCE_ATTRIBUTES="department=payments,team=checkout"

Od tej chwili claude_code.cost.usage i claude_code.token.usage trafiają do backendu w podziale na department, team, model i user.account_uuid, więc jeden panel w Grafanie odpowiada na pytanie “który zespół wydał ile i na jakim modelu”.

Wdrożenie przez managed settings

Przy wdrożeniu w całej organizacji rozdaj te ustawienia plikiem managed settings, zamiast prosić każdego dewelopera o ustawianie zmiennych środowiskowych:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.company.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer company-token"
  }
}

Wskazówka

Managed settings copy-paste do minimalnego wdrożenia telemetrii, do katalogu managed settings właściwego dla twojej platformy:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://otel-collector.internal:4317"
  }
}

Różnica względem bloku powyżej jest celowa: bez nagłówka autoryzacji i bez jawnego protokołu, co wystarcza dla kolektora w zaufanej sieci wewnętrznej. Dodaj oba z powrotem w chwili, gdy kolektor stanie się osiągalny spoza niej.

Wskazówka

Prompt copy-paste do postawienia eksportera i alertu budżetowego:

Set up Claude Code cost telemetry for our team. In managed-settings.json, add an
env block that enables CLAUDE_CODE_ENABLE_TELEMETRY, exports metrics via OTLP/gRPC
to http://collector.company.com:4317, and tags sessions with department and team
via OTEL_RESOURCE_ATTRIBUTES. Then write a Prometheus/Grafana alert rule that fires
when the sum of claude_code.cost.usage over the last 24h, grouped by department,
exceeds a configurable threshold. Output the settings JSON and the alert YAML only.

Metryki warte wykresu

Wszystkie nazwy metryk i zdarzeń noszą przestrzeń nazw claude_code. — w zapytaniach do dashboardu używaj pełnej nazwy, inaczej filtry nie trafią.

Metryka	Typ	Co śledzi
claude_code.session.count	Licznik	Rozpoczęte sesje
claude_code.lines_of_code.count	Licznik	Linie dodane/usunięte przez Claude
claude_code.pull_request.count	Licznik	Utworzone PR-y
claude_code.commit.count	Licznik	Wykonane commity
claude_code.cost.usage	Licznik	Koszt wywołań API w dolarach
claude_code.token.usage	Licznik	Tokeny wejściowe i wyjściowe
claude_code.code_edit_tool.decision	Licznik	Decyzje zgody/odmowy dla narzędzia edycji
claude_code.active_time.total	Licznik	Czas aktywnej sesji w sekundach

Koszt siedzi w claude_code.cost.usage, a reszta zamienia wykres wydatków w wykres ROI, bo lines_of_code.count, pull_request.count i commit.count to strona wynikowa tego samego ułamka.

Zdarzenia warte logowania

Zdarzenie	Co rejestruje
claude_code.user_prompt	Moment wysłania promptu (treść opcjonalnie przez OTEL_LOG_USER_PROMPTS=1)
claude_code.tool_result	Wyniki i skutki wywołań narzędzi
claude_code.api_request	Szczegóły wywołań API (model, tokeny, opóźnienie)
claude_code.api_error	Błędy API i limity przepustowości
claude_code.tool_decision	Decyzje o uprawnieniach dla wywołań narzędzi

O api_error zespoły bezpieczeństwa i platformy pytają najpierw: to tam widać odrzucenia z powodu limitów, zanim ktokolwiek zgłosi zgłoszenie, że Claude “działa wolno”.

Twarde barierki dla automatyzacji

Sesje interaktywne same się korygują — deweloper widzi rozbieganą pętlę i wciska Escape. Przebiegi headless i CI nie mają takiej możliwości. Przy każdym nieinteraktywnym wywołaniu claude -p ogranicz zasięg rażenia flagami trybu print:

# Stop spending past $5 on this run, and never exceed 8 agentic turns
claude -p "Triage failing tests in src/ and propose fixes" \
  --max-budget-usd 5.00 \
  --max-turns 8 \
  --model sonnet

--max-budget-usd zatrzymuje przebieg, gdy wydatek na API przekroczy limit, a --max-turns kończy go błędem po N turach agenta, żeby rozbiegana pętla nie spaliła budżetu bez nadzoru. Obie flagi działają wyłącznie w trybie print (-p).

Uwaga

--max-budget-usd to stop, nie zwrot pieniędzy — zatrzymuje przebieg po przekroczeniu progu, więc ustaw go poniżej prawdziwego sufitu. Odnosi się też wyłącznie do rozliczenia kluczem API; przy abonamencie nie ma licznika w dolarach, na którym mógłby się oprzeć. W CI lepszym zabezpieczeniem są dedykowane klucze API z limitami wydatków workspace’u.

Dobieranie modelu do zadania

Największą dźwignią kosztową nie jest pomiar, tylko wybór modelu. W cenniku startowym Sonneta 5, obowiązującym do 31 sierpnia, token kosztuje dwie piąte tego co u Opusa 5, a potem trzy piąte. Haiku 4.5 jest jeszcze tańsze — około jednej piątej Opusa — i nadaje się do pracy mechanicznej.

Model	Orientacyjna cena (wejście / wyjście za Mtok)	Sięgaj po niego, gdy
Claude Fable 5	~$10 / ~$50	Planowanie w Plan Mode, złożone refaktory wieloplikowe, budowa od zera i końcowa weryfikacja przy najtrudniejszych zadaniach (2x Opus)
Claude Opus 5	~$5 / ~$25	Decyzje architektoniczne, wieloetapowe rozumowanie, paskudny debugging, audyty bezpieczeństwa
Claude Sonnet 5	$2 / $10 do 31 sierpnia, potem $3 / $15	Codzienne kodowanie, code review, większość poprawek błędów, refaktory, pisanie testów
Claude Haiku 4.5	~$1 / ~$5	Formatowanie, poprawki lintera, komentarze, masowe edycje mechaniczne, trywialni subagenci

Pełny cennik znajdziesz w porównaniu modeli. Claude Fable 5 stoi o poziom wyżej niż Opus 5 i kosztuje dokładnie dwa razy tyle. Przy ograniczonym budżecie traktuj go jak klamrę, a nie domyślny wybór — eskaluj do Fable 5 (/model fable) przy planowaniu i końcowej weryfikacji, a implementację prowadź na Sonnecie 5 albo Opusie 5. Jeśli ustawisz Fable jako domyślny, przypnij tańsze modele subagentom wprost; inaczej dziedziczą zgodnie ze swoją konfiguracją, a nie schodzą automatycznie na tańsze poziomy.

Model zmienisz w trakcie sesji przez /model, a domyślny ustawisz w /config.

Wskazówka

Prompt copy-paste do spisania polityki schodzenia na tańszy model, którą zespół może przyjąć:

Draft a short Claude Code model-selection policy for our team as a CLAUDE.md
section. Rules: default to Sonnet 5; escalate to Opus 5 only for architecture
or multi-step debugging and note why in the commit; escalate to Fable 5 (/model
fable) only for Plan-mode planning and the final verification pass — implementation
stays on Sonnet or Opus; route formatting, lint fixes, and comment generation to
Haiku 4.5; require every subagent definition to set an explicit model (haiku for
mechanical work). Add a note that teams where budget matters less than velocity
may default to Fable 5 instead, but must pin cheaper subagent models explicitly. Include
a one-line /model command for each case. Keep it under 15 lines.

Wskazówka

Sekcja CLAUDE.md copy-paste do pracy z okiem na koszty, gdy wolisz mieć reguły w repozytorium od dziś niż dokument polityki do zatwierdzenia:

# Cost Management Rules

- Use Sonnet for all tasks unless I specifically request Opus or Fable
- Reserve Fable 5 (/model fable) for complex multi-file refactors, greenfield builds, and final verification passes where quality matters most
- Before reading files, use grep to find relevant sections first
- When exploring a codebase, start with directory listing and README, not reading every file
- Delegate multi-file operations to subagents with model: sonnet
- Clear context between unrelated tasks

Przycinaj kontekst, zanim przytnie twój budżet

Koszt tokenów jest wprost funkcją rozmiaru kontekstu. Claude Code sam kompaktuje przy limicie i cache’uje prompt systemowy, ale tanie zwycięstwa biorą się z nawyków.

Czyszczenie, kompaktowanie i miejsce na reguły kompaktowania

• /clear między niepowiązanymi zadaniami. Za nieświeży kontekst płacisz przy każdej kolejnej wiadomości. Użyj /rename przed czyszczeniem, żeby móc później wrócić przez /resume.

• Steruj kompaktowaniem. /compact Keep test output and code changes. Summarize discussion. mówi Claude, co zachować przy streszczaniu.

• Zapisz regułę kompaktowania raz. Wpisz ją do CLAUDE.md, żeby nie przeklepywać jej w każdej sesji:

  # Compact instructions
  When compacting, preserve test output, error traces, and file paths. Summarize discussion and reasoning.

• Zrzuć robotę na hooki. Hook PreToolUse potrafi przegrepować dziesięciotysięczny log do samych pasujących błędów, zanim Claude go w ogóle przeczyta — dziesiątki tysięcy tokenów zamieniają się w setki.

• Przenieś instrukcje procesowe z CLAUDE.md do skilli. CLAUDE.md ładuje się na starcie sesji i jest rozliczany nawet przy niepowiązanej pracy, a skille wczytują się na żądanie. Trzymaj CLAUDE.md poniżej ~500 linii.

• Zainstaluj wtyczki code intelligence dla języków typowanych. Dają Claude precyzyjną nawigację po symbolach zamiast grepowania i czytania wielu plików, co ścina koszt eksploracji w bazach TypeScriptu, Go, Rusta i pokrewnych.

• Dostrój rozumowanie adaptacyjne. Przy prostych zadaniach obniż poziom wysiłku komendą /effort albo suwakiem w /model. Dodatni limit MAX_THINKING_TOKENS działa dopiero po włączeniu trybu stałego budżetu na Opusie/Sonnecie 4.6, a myślenia Fable 5 wyłączyć się nie da. Tokeny myślenia rozliczają się jak wyjściowe.

Wskazówka

Prompt copy-paste do audytu sesji, która zrobiła się droga:

Run /context and /cost, then tell me exactly what is inflating this session's token
usage. Identify any MCP servers I'm not using right now, stale files from earlier
unrelated work, and conversation history that's safe to drop. Recommend whether to
/clear, /compact (with specific focus instructions), or disable an MCP server, and
give me the exact commands to run.

Wskazówka

Prompt copy-paste do świadomego kosztowo prowadzenia kontekstu, na otwarcie sesji, po której już spodziewasz się długiej pracy:

Before starting this task, check /cost. If we have used more than $2 in this session,
use /compact first to reduce context. Focus on the specific files involved -- do not
read entire directories when grep can find what we need.

Ścinanie narzutu MCP

Każdy podpięty serwer MCP dokłada do kontekstu definicje narzędzi i zjada tokeny nawet wtedy, gdy nic nie robi:

• Uruchom /context, żeby zobaczyć, co zajmuje miejsce, a potem /mcp, żeby wyłączyć nieużywane serwery
• Tam, gdzie się da, wybieraj narzędzia CLI (gh, aws, gcloud, sentry-cli) zamiast serwerów MCP — nie dokładają trwałych definicji do kontekstu
• Ustaw ENABLE_TOOL_SEARCH=auto:5, żeby wyszukiwanie narzędzi MCP włączało się, gdy definicje przekroczą 5% okna kontekstu (domyślny próg to 10%). Odroczone narzędzia wchodzą do kontekstu dopiero przy użyciu, więc niższy próg wycina bezczynne definicje

Delegowanie do subagentów

Subagenci mają własne okna kontekstu i to właśnie czyni z nich dźwignię kosztową, a nie tylko porządkową. Używaj ich do operacji gadatliwych (czytanie wielu plików, uruchamianie zestawów testów), do pracy równoległej, która inaczej rozdęłaby główny kontekst, i do powtarzalnych edycji w wielu plikach.

Oszczędność pojawia się dopiero wtedy, gdy przypniesz model. Dla trywialnych subagentów użyj model: haiku, a dla tych wymagających prawdziwego rozumowania model: sonnet:

---
name: test-runner
description: Runs the test suite and returns only failures
tools: [Bash, Read]
model: haiku
---
You run the project's test command, then summarize only failing tests and their
error messages. Never paste full passing output.

Limity przepustowości dopasowane do wielkości zespołu

W workspace’ach API limity na użytkownika powinny spadać wraz ze wzrostem zespołu, bo nie wszyscy pracują jednocześnie:

Wielkość zespołu	TPM na użytkownika	RPM na użytkownika
1-5	200k-300k	5-7
5-20	100k-150k	2.5-3.5
20-50	50k-75k	1.25-1.75
50-100	25k-35k	0.62-0.87
100-500	15k-20k	0.37-0.47

Traktuj to jako punkty wyjścia i obserwuj claude_code.api_error pod kątem odrzuceń limitowych, zamiast czekać na skargi.

Gdy kontrola kosztów przestaje działać

• /cost pokazuje grosze, a rachunek jest ogromny. Albo jesteś na abonamencie, gdzie /cost nie jest fakturą, albo wydatek generują klucze CI, które nigdy nie wywołują /cost interaktywnie. Uzgadniaj to z raportami workspace’u w konsoli i zużyciem per klucz, nie z wyjściem sesji.
• Dane telemetryczne w ogóle się nie pojawiają. Sprawdź, czy CLAUDE_CODE_ENABLE_TELEMETRY=1 jest faktycznie ustawione i czy endpoint OTLP jest osiągalny z maszyn deweloperów. Metryki eksportują się domyślnie co 60 sekund, więc odczekaj przynajmniej tyle, zanim zaczniesz szukać głębiej.
• Dashboard OTel jest pusty na Bedrocku/Vertexie/Foundry. Claude Code nie wysyła metryk kosztowych przez dostawców chmury. Śledź przez rozliczenia dostawcy albo gateway LiteLLM z wydatkiem per klucz; zobacz LLM Gateway.
• --max-budget-usd nie zatrzymał rozbieganego zadania. Działa wyłącznie w trybie print i egzekwuje wyłącznie rozliczenie kluczem API. Przy abonamentach i sesjach interaktywnych nie ma licznika w dolarach — zostają limity wydatków workspace’u i --max-turns.
• Telemetria się opóźnia albo zalewa backend. Metryki lecą domyślnie co 60 s, logi co 5 s. Dostrój OTEL_METRIC_EXPORT_INTERVAL i użyj kontroli kardynalności OTEL_METRICS_INCLUDE_*, żeby zbić koszty składowania — eksplozja metryk per identyfikator sesji potrafi kosztować więcej niż zużycie Claude, które mierzysz.
• Limity gryzą podczas onboardingu albo szkolenia. Wytyczne na użytkownika zakładają średnią równoczesność. Na tydzień, w którym wszyscy siedzą w narzędziu naraz, podnieś limity tymczasowo albo rozłóż sesje w czasie.
• Koszty są wyższe, niż powinny, i nie widać winowajcy. Uruchom /context: duże konfiguracje MCP i rozdęte pliki auto-pamięci pompują każde pojedyncze żądanie, a nigdy niewyczyszczona sesja wciąż nalicza pracę, którą skończyłeś wczoraj.
• Zejście na tańszy model zabija jakość. Cięcia kosztów, które produkują zepsuty kod, nie są oszczędnością. Zostaw Opusa 5 dostępnego dla trudnych 10% i mierz poprawki, nie tylko zużycie tokenów.
• Zostawienie Fable 5 jako domyślnego bez budżetu na kredyty zużycia. Od 20 lipca 2026 jest na stałe wliczony w Max i Team Premium do 50% tygodniowych limitów zużycia, ale na Pro i Team Standard rozlicza kredyty w stawce 2x Opus. Zawęź go z powrotem do planowania i końcowej weryfikacji, chyba że ten dodatkowy wydatek jest świadomą decyzją.

Dokąd dalej z kontrolą kosztów

• LLM Gateway — twarde budżety i wydatki per klucz na Bedrocku/Vertexie
• Integracja korporacyjna — wdrożenie w całej firmie i managed settings
• Integracja CI/CD — śledzenie kosztów pipeline’u obok zużycia deweloperów
• Wydajność i koszty — krótka lista taktyk ograniczania tokenów

Skuteczna kontrola kosztów to kwestia równowagi: maksymalizuj wartość, wycinaj marnotrawstwo. Najpierw widoczność przez /cost, /stats i OTel, potem routing modeli i barierki. Większość zespołów ścina 30-50% bez straty tempa — samym czyszczeniem kontekstu, dobieraniem modeli i wyłączaniem serwerów MCP, o których zapomniała.