Monitorowanie Użycia i Optymalizacja Kosztów

Twój zespół finansowy chce wiedzieć, ile kosztuje Claude Code na developera miesięcznie. Twój manager inżynieryjny chce wiedzieć, które zespoły uzyskują największą wartość. Twój zespół bezpieczeństwa chce logów audytowych. Bez telemetrii zgadujesz. Z OpenTelemetry masz dashboardy odpowiadające na każde pytanie.

Co Wyniesiecie z Tego Rozdziału

• Konfiguracja OpenTelemetry dla metryk i logowania zdarzeń
• Komenda /cost i linia statusu dla indywidualnego śledzenia
• Zarządzanie kosztami zespołowymi z limitami workspace i rate limiting
• Strategie redukcji tokenów obniżające koszty bez zmniejszania efektywności
• Praktyczny framework do mierzenia ROI Claude Code

Indywidualne Śledzenie Kosztów

Komenda /cost

Każdy developer może śledzić koszty swojej sesji w czasie rzeczywistym:

/cost

Wynik:

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

Dla ciągłej widoczności skonfiguruj swoją linię statusu tak, aby pokazywała użycie tokenów. Zobacz dokumentację linii statusu dla opcji konfiguracji.

Notatka

Komenda /cost pokazuje koszty tokenów API i jest istotna dla użytkowników API. Subskrybenci Claude Max i Pro mają użycie wliczone w subskrypcję. Subskrybenci mogą zamiast tego użyć /stats aby zobaczyć swoje wzorce użycia.

Typowe Zakresy Kosztów

Na podstawie opublikowanych danych Anthropic:

Metryka	Wartość
Średni koszt na developera dziennie	$6
90. percentyl kosztu dziennego	$12
Średnia miesięczna (Sonnet)	$100-200/developer
Średnia miesięczna (intensywne użycie Opus)	$300-500/developer

Konfiguracja OpenTelemetry

Szybki Start

# Włącz telemetrię
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# Skonfiguruj eksporter OTLP
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# Opcjonalnie: uwierzytelnianie
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# Uruchom Claude Code
claude

Wdrożenie na Poziomie Organizacji

Wdróż przez ustawienia zarządzane, aby każdy developer automatycznie raportował telemetrię:

{
  "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

Gotowe ustawienia zarządzane do skopiowania dla pełnego wdrożenia telemetrii:

Umieść w katalogu ustawień zarządzanych 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"
  }
}

Dostępne Metryki

Wszystkie nazwy metryk i zdarzeń są opatrzone przestrzenią nazw claude_code. — używaj pełnej nazwy podczas budowania zapytań dashboardów, w przeciwnym razie Twoje filtry nie zadziałają.

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

Dostępne Zdarzenia

Zdarzenie	Co Przechwytuje
claude_code.user_prompt	Kiedy prompty są wysyłane (zawartość opcjonalna przez OTEL_LOG_USER_PROMPTS=1)
claude_code.tool_result	Wyniki wywołań narzędzi i rezultaty
claude_code.api_request	Szczegóły wywołań API (model, tokeny, opóźnienie)
claude_code.api_error	Błędy API i rate limity
claude_code.tool_decision	Decyzje uprawnień dla wywołań narzędzi

Zarządzanie Kosztami Zespołowymi

Limity Wydatków Workspace

Dla użytkowników API ustaw limity wydatków na poziomie workspace w Konsoli Anthropic:

1. Przejdź do console.anthropic.com
2. Przejdź do swojego workspace Claude Code (auto-utworzonego przy pierwszym uwierzytelnieniu)
3. Ustaw miesięczne limity wydatków dla workspace

Wytyczne Rate Limit

Rozmiar 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

TPM na użytkownika maleje z rozmiarem zespołu, ponieważ nie wszyscy użytkownicy są aktywni jednocześnie.

Strategie Redukcji Tokenów

Zarządzaj Kontekstem Proaktywnie

Rozmiar kontekstu bezpośrednio wpływa na koszt. Każda wiadomość zawiera pełną historię konwersacji.

• Czyść między zadaniami: /clear przy przełączaniu na niepowiązaną pracę
• Używaj targetowanej kompaktacji: /compact Keep test output and code changes. Summarize discussion.
• Dodaj instrukcje kompaktacji do CLAUDE.md:

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

Wskazówka

Gotowy prompt do skopiowania dla zarządzania kosztami świadomego kontekstu:

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.

Wybierz Właściwy Model

Zadanie	Zalecany Model	Dlaczego
Code review	Sonnet	Wystarczająco dobry, znacznie tańszy
Naprawy bugów	Sonnet	Większość bugów nie wymaga rozumowania na poziomie Opus
Decyzje architektoniczne	Opus	Złożone wieloetapowe rozumowanie korzysta z Opus
Złożone refaktoringi wielu plików, budowanie od zera	Fable 5	Szczytowa inteligencja; używaj gdy jakość i szybkość ważniejsze niż budżet
Proste edycje plików	Sonnet (lub Haiku dla subagentów)	Przesada używać Opus
Audyty bezpieczeństwa	Opus	Niuansowana analiza wymaga głębszego rozumowania

Zobacz porównanie modeli dla szczegółów cenowych. Fable 5 kosztuje $10/$50 za milion tokenów (wejście/wyjście) — dokładnie 2× Opus 4.8.

Przełączaj modele w trakcie sesji za pomocą /model lub ustaw domyślne w /config.

Zmniejsz Narzut Serwerów MCP

Każdy serwer MCP dodaje definicje narzędzi do Twojego kontekstu, zużywając tokeny nawet gdy jest nieaktywny:

• Uruchom /context aby zobaczyć co zużywa miejsce
• Wyłącz nieużywane serwery za pomocą /mcp
• Preferuj narzędzia CLI (gh, aws, gcloud) nad serwerami MCP gdy to możliwe
• Ustaw ENABLE_TOOL_SEARCH=auto:5, aby uruchamiać wyszukiwanie narzędzi MCP, gdy definicje narzędzi przekraczają 5% okna kontekstu (domyślny próg to 10%). Odroczone narzędzia wchodzą do kontekstu dopiero gdy są faktycznie użyte, więc niższy próg przycina nieaktywne definicje

Deleguj do Subagentów

Subagenci mają własne okna kontekstu. Używaj ich do:

• Gadatliwych operacji (czytanie wielu plików, uruchamianie zestawów testów)
• Równoległych zadań, które inaczej rozdęłyby główny kontekst
• Powtarzalnych operacji (stosowanie tej samej zmiany w wielu plikach)

Konfiguruj subagentów z tańszymi modelami. Używaj model: haiku dla trywialnych subagentów (mechaniczne edycje, skanowanie plików) i model: sonnet dla tych, które potrzebują prawdziwego rozumowania:

---
model: haiku
---

Wskazówka

Gotowa sekcja CLAUDE.md do skopiowania dla rozwoju świadomego kosztów:

# 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

Więcej Dźwigni Wartych Poznania

Kilka dodatkowych pokręteł z aktualnych wytycznych dotyczących kosztów:

• Zainstaluj wtyczki inteligencji kodu dla języków typowanych: dają Claude’owi precyzyjną nawigację po symbolach zamiast grep-a i czytania wielu plików, ograniczając eksploracyjne wydatki tokenów na bazach kodu TypeScript, Go, Rust i podobnych.
• Przenieś instrukcje specyficzne dla workflow z CLAUDE.md do skilli: CLAUDE.md ładuje się na początku sesji, więc szczegółowe instrukcje code review PR czy migracji kosztują tokeny nawet przy niepowiązanej pracy. Skille ładują się na żądanie tylko gdy są wywoływane. Staraj się trzymać CLAUDE.md poniżej ~500 linii.
• Dostrój budżet rozszerzonego myślenia: tokeny myślenia są rozliczane jako wyjściowe. Dla prostszych zadań obniż poziom wysiłku w /model, wyłącz myślenie w /config lub ogranicz budżet za pomocą MAX_THINKING_TOKENS (na przykład MAX_THINKING_TOKENS=8000).

Kiedy To Nie Działa

Dane telemetryczne nie pojawiają się: Sprawdź czy CLAUDE_CODE_ENABLE_TELEMETRY=1 jest ustawione. Zweryfikuj, że endpoint OTLP jest osiągalny z maszyn developerów. Domyślny interwał eksportu to 60 sekund dla metryk — poczekaj przynajmniej tyle przed debugowaniem.

Koszty wyższe niż oczekiwano: Sprawdź /context aby zobaczyć co zużywa miejsce. Duże konfiguracje serwerów MCP lub rozdęte pliki automatycznej pamięci pompują każde żądanie. Sprawdź także sesje, które nigdy nie zostały wyczyszczone — nieaktualny kontekst się kumuluje.

Rate limity osiągane podczas okresów wysokiego użycia: Wytyczne TPM na użytkownika zakładają średnią współbieżność. Podczas sesji szkoleniowych lub wydarzeń onboardingowych tymczasowo zwiększ limity lub rozłóż użycie.

Koszty Bedrock/Vertex nie śledzone: Claude Code nie wysyła metryk od Twojego dostawcy chmury. Użyj LiteLLM lub własnego śledzenia kosztów dostawcy chmury dla rozliczeń Bedrock/Vertex.

Co Dalej

• Integracja Korporacyjna — Wdrożenie telemetrii na poziomie organizacji
• GitHub Actions — Śledź koszty CI obok użycia developerów
• Wskazówki Wydajności i Kosztów — 10 konkretnych wskazówek redukcji użycia tokenów