Poziomy effort w Claude - low, medium, high, xhigh i max (kiedy używać którego)

Seria Claude Code · JSystems

Wyobraź sobie, że ten sam człowiek potrafi odpowiedzieć na pytanie odruchowo, w pół sekundy - albo usiąść, rozpisać warianty na kartce, sprawdzić własne założenia i dopiero wtedy się odezwać. Z Claude jest dokładnie tak. To nie kwestia "lepszego" czy "gorszego" modelu. To jedno pokrętło, którym mówisz: myśl płycej, bo się spieszę albo zwolnij, to jest trudne, daj z siebie wszystko.

To pokrętło nazywa się effort. Większość ludzi go nie rusza i przepala tokeny na trywialnych zadaniach albo dostaje płytkie odpowiedzi na trudnych - bo nie wie, że może nim sterować. Ten artykuł to zmienia: poznasz wszystkie poziomy, ciekawostki, których nie ma w dokumentacji "między wierszami", i konkretne reguły kiedy którego użyć.

Czym jest effort - jeden model, regulowana głębia

Effort to ustawienie, które kontroluje, jak chętnie Claude wydaje tokeny przy rozwiązywaniu zadania. Mówiąc prościej: jak głęboko rozumuje, zanim się odezwie. Niski effort to szybka, oszczędna odpowiedź. Wysoki to model, który generuje wewnętrzne ciągi rozumowania, analizuje problem z kilku stron, weryfikuje własne tezy, a gdy wykryje sprzeczność w swoim toku myślenia - cofa się i próbuje inaczej.

Najważniejsze, co odróżnia effort od wyboru modelu: to wciąż ten sam model. Nie schodzisz na "głupszą" wersję, żeby było taniej. Bierzesz tę samą inteligencję i decydujesz, ile wysiłku ma w nią włożyć przy tym konkretnym zapytaniu.

Pięć poziomów (plus jeden bonus w Claude Code)

Przejdźmy przez nie od najlżejszego do najcięższego. Każdy ma swoją naturalną "strefę wygranej".

Skrót: który poziom do czego

Chcesz wycisnąć z Claude maksimum w realnej pracy z kodem i agentami? --> Szkolenie Claude Code z terminem gwarantowanym - 3 dni warsztatów z trenerem.

Effort to sygnał, nie twardy limit

Tu jest niuans, na którym wielu się potyka. Effort nie jest sztywnym budżetem tokenów. To sygnał behawioralny - opis nastawienia. Na niskim effort Claude i tak pomyśli, jeśli trafi na wystarczająco trudny problem - po prostu pomyśli mniej, niż zrobiłby to na wyższym poziomie przy tym samym zadaniu.

Praktyczny wniosek: jeśli widzisz płytkie rozumowanie na trudnym zadaniu, podnieś effort, zamiast obudowywać prompt sztuczkami. A jeśli z jakiegoś powodu musisz zostać na niskim poziomie (np. zależy ci na czasie reakcji), dorzuć do promptu wyraźną wskazówkę w stylu: "To zadanie wymaga wieloetapowego rozumowania. Przemyśl je dokładnie, zanim odpowiesz."

Pułapka: więcej nie zawsze znaczy lepiej

Naturalny odruch brzmi: "skoro mogę dać max, to dawajmy max na wszystko". To błąd, który kosztuje pieniądze, a czasem nawet jakość. Na większości zadań max dokłada znaczący koszt przy stosunkowo małym przyroście jakości. Co gorsza, na zadaniach o sztywnej strukturze (np. generowanie ściśle określonego formatu wyjścia) potrafi prowadzić do nadmyślenia - model "kombinuje" tam, gdzie wystarczyło zrobić prosto.

Dlatego rekomendacja jest taka: zacznij od poziomu adekwatnego do zadania (dla kodu i pracy agentowej - xhigh na najnowszych Opusach, dla reszty - high), a po max sięgaj dopiero, gdy twoje własne testy pokażą, że jest jeszcze zysk do wzięcia. Schodź na medium albo low, gdy zmierzysz, że niższy poziom utrzymuje jakość.

Jak ustawić effort w API

W API effort podaje się jako osobny parametr najwyższego poziomu (nie jako zagnieżdżony obiekt). Jedna linijka i tyle:

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Porównaj architekturę monolitu i mikroserwisów"}],
    effort="medium",  # low | medium | high | xhigh | max
)

print(response.content[0].text)

Brak nagłówka beta, brak osobnej konfiguracji - parametr jest dostępny od ręki na wszystkich wspieranych modelach. Domyślnie i tak dostajesz high, więc ustawiasz go wtedy, gdy chcesz coś innego.

Jak ustawić effort w Claude Code

W narzędziu Claude Code (terminalowy asystent kodujący) masz to wygodnie pod ręką. Najprościej - komenda /effort:

/effort              # otwiera interaktywny suwak
/effort medium       # ustawia od razu wybrany poziom
/effort auto         # wraca do poziomu domyślnego dla modelu

Poza komendą masz kilka innych dróg, ułożonych według priorytetu (zmienna środowiskowa wygrywa z resztą):

• suwak effort widoczny przy wyborze modelu (/model, strzałki lewo-prawo),
• flaga przy starcie: --effort xhigh (na jedną sesję),
• zmienna środowiskowa CLAUDE_CODE_EFFORT_LEVEL,
• pole effortLevel w pliku ustawień (na stałe),
• pole effort we frontmatterze konkretnej umiejętności (skill) lub subagenta - nadpisuje poziom sesji, gdy ten skill/subagent działa.

Effort kontra "ultrathink" - dwa różne narzędzia

Tu kryje się jedna z najfajniejszych ciekawostek. W Claude Code możesz wpisać gdziekolwiek w prompcie słowo ultrathink - i poprosić o głębsze rozumowanie tylko w tej jednej turze, bez zmieniania ustawienia effort dla całej sesji. Narzędzie rozpoznaje to słowo kluczowe i dorzuca odpowiednią instrukcję w kontekście.

Różnica jest więc taka:

• effort = nastawienie całej sesji, dopóki go nie zmienisz,
• ultrathink w prompcie = zastrzyk głębszego myślenia na jedną wiadomość.

Który poziom na którym modelu

Nie każdy model rozumie każdy poziom. Skrajne tryby (xhigh, max) to domena najmocniejszych modeli. Jeśli ustawisz poziom, którego dany model nie obsługuje, narzędzie zejdzie do najwyższego dostępnego poniżej (np. xhigh zadziała jak high na modelu bez xhigh). Poniżej zdjęcie stanu - traktuj je jako migawkę, bo lista modeli rośnie:

Stan na czerwiec 2026. Sama nazwa poziomu nie znaczy tej samej "ilości" myślenia na różnych modelach - skala jest kalibrowana osobno dla każdego z nich.

Zauważ, że w menu /effort widać szóstą pozycję - ultracode - której w tej tabeli celowo nie ma. To nie jest poziom modelu, lecz tryb samego Claude Code: nie ustawia budżetu myślenia, tylko uruchamia wieloagentową orkiestrację (model pracuje na xhigh i rozdziela pracę między równoległych agentów). Działa więc niezależnie od modelu - wszędzie tam, gdzie dostępny jest xhigh.

Najczęstsze błędy przy doborze effort

Prosta reguła na koniec

Jeśli masz zapamiętać jedno zdanie, niech będzie to: ustawiaj effort świadomie, zamiast jechać na domyślnym dla wszystkiego. Praktyczny algorytm:

• Proste, masowe, czuły na czas? --> low (albo medium).
• Codzienna robota agentowa i kodowa z okiem na koszt? --> medium.
• Trudniejsze rozumowanie, jakość ważniejsza od kosztu? --> high (domyślny).
• Poważne kodowanie, długa praca agentowa, eksploracja repo? --> xhigh.
• Graniczny, otwarty problem bez ograniczeń budżetu? --> max (i tylko gdy testy to uzasadniają).
• Duża, wieloetapowa robota w Claude Code, którą chcesz rozbić na zespół agentów? --> ultracode.

Reszta to mierzenie. Effort to nie magia - to świadomy kompromis między jakością, czasem i rachunkiem za tokeny, który dostroisz na własnych zadaniach w kilka minut.