TL;DR
Claude Sonnet 5.5 to szybki model do jasno zdefiniowanego kodowania, pracy z dokumentami i przepływów z użyciem narzędzi. Anthropic podaje ponad 30% szybsze generowanie niż Sonnet 5 przy tych samych standardowych stawkach tokenów. Zacznij od klucza CometAPI, identyfikatora modelu claude-sonnet-5-5 i małego żądania Messages lub Chat Completions. Istniejące agenty powinny ponownie przetestować thinking, wybór narzędzi i odtwarzanie historii przed wdrożeniem.
Key Takeaways
- Używaj Claude Sonnet 5.5 i dopasuj format żądania do wybranego endpointu.
- Zacznij od jednego krótkiego żądania, zanim dodasz obrazy, narzędzia lub długi kontekst.
- Użyj Messages dla kontroli specyficznych dla Claude; użyj Chat Completions, jeśli masz istniejącą aplikację z OpenAI SDK.
- Przejrzyj zmiany w thinking i wyborze narzędzi przed migracją istniejących pętli agenta.
- Porównaj jakość zaakceptowanych zadań, opóźnienia, zużycie tokenów i trafienia cache przed rozszerzeniem ruchu.
What Is Claude Sonnet 5.5?
Claude Sonnet 5.5 API to programistyczny interfejs do modelu Sonnet 5.5 firmy Anthropic. Zaprojektowany jest do zadań takich jak rozwój oprogramowania, analiza repozytoriów, automatyzacja wsparcia klienta, przetwarzanie dokumentów, rozumienie obrazów, agenci korzystający z narzędzi oraz ustrukturyzowane profesjonalne przepływy pracy.
Anthropic pozycjonuje Sonnet 5.5 jako szybsze, tańsze uzupełnienie Opus 5.5, drugi model w rodzinie Claude 5.5, zoptymalizowany pod kątem dobrze zdefiniowanego kodowania, naprawiania błędów, tworzenia dokumentów i slajdów oraz codziennych zadań profesjonalnych. Deweloperzy mogą uzyskać dostęp do Claude Sonnet 5.5 API w CometAPI, używając claude-sonnet-5-5.
| Specyfikacja | Claude Sonnet 5.5 |
|---|---|
| Dostawca | Anthropic |
| Model ID | claude-sonnet-5-5 |
| Data wydania | September 28, 2026 |
| Okno kontekstu | 1M tokens |
| Maksymalny synchroniczny output | 128K tokens |
| Maksymalny output wsadowy | Up to 300K tokens in supported beta configuration |
| Wejścia | Text, images |
| Wyjście | Text |
| Thinking | Adaptive thinking |
| Domyślny effort Claude API | High |
| Granica wiedzy | June 2026 |
| Cena wejścia (Anthropic / CometAPI) | $2.00 / $1.60 per 1M tokens |
| Cena wyjścia (Anthropic / CometAPI) | $10.00 / $8.00 per 1M tokens |
Anthropic potwierdza okno kontekstu 1M tokenów i limit 128K tokenów dla synchronicznego outputu. Output wsadowy może osiągnąć 300K tokenów wyłącznie poprzez Message Batches z nagłówkiem beta output-300k-2026-03-24. Obsługę funkcji Gateway należy sprawdzić osobno względem wsparcia na poziomie modelu.
How Does Claude Sonnet 5.5 Perform on Official Benchmarks?
Poniższe zwarte zestawienie pomaga wskazać obciążenia do oceny przed przyjęciem API. Wyniki benchmarków nie zastępują testów własnych promptów i pętli narzędzi.
| Benchmark | Claude Sonnet 5.5 | Claude Sonnet 5 | Claude Opus 5.5 |
|---|---|---|---|
| Terminal-Bench 4.0 | 70.6% | 10.3% | 66.4% at Xhigh |
| FrontierCode 1.1 Main | 46.2% at Max / 52.1% at Xhigh | 42.4% | 54.4% |
| CursorBench 4.0 | 55.5% | 34.1% | 57.8% |
| GDPval-AA v2.1 | 1844 | 1449 | 1846 |
| OSWorld 2.1, partial | 80.1% | 57.0% | 81.8% |
| AA-Briefcase v1.1 | 1811 | 1359 | 1822 |
| Humanity’s Last Exam, with tools | 64.5% | 54.9% | 67.7% |
| Chartography, no tools | 61.6% | 15.6% | 64.4% |
Wyniki benchmarków i notatki ewaluacyjne Anthropic stanowią podstawę tego porównania. Wynik Opus 5.5 na Terminal-Bench używa wysiłku Xhigh; FrontierCode raportuje osobno wyniki Max i Xhigh dla Sonnet 5.5; OSWorld to częściowa ewaluacja. GDPval-AA i AA-Briefcase zostały uruchomione przez Artificial Analysis na przedpremierowym wdrożeniu Claude Platform z błędem strukturalnego outputu, który prawdopodobnie zaniżył wynik Sonnet 5.5; Anthropic twierdzi, że błąd został od tego czasu naprawiony. Te wyniki powinny kierunkować testowanie obciążeń zamiast gwarantować rezultaty produkcyjne. Humanity’s Last Exam używa narzędzi; Chartography nie. Nowe wiersze używają opublikowanych wyników Anthropic. Oryginalny obraz poniżej został zachowany; rozszerzona tabela obejmuje trzy dodatkowe ewaluacje.
Oficjalne porównanie benchmarków Claude Sonnet 5.5
What Changed in Claude Sonnet 5.5 API From Sonnet 5?
| Wymiar | Claude Sonnet 5.5 | Wpływ na migrację |
|---|---|---|
| Prędkość outputu | Zgłaszane generowanie szybsze o 30%+ | Ustal na nowo bazowe opóźnienia |
| Oficjalne stawki tokenów | Te same $2 input / $10 output per MTok | Porównaj całkowity koszt zadania |
| Najniższa opcja thinking | between_tools zastępuje disabled | Zaktualizuj konfigurację thinking |
| Wymuszony wybór narzędzia | Odrzucone any i wymuszanie nazw | Użyj auto; sekwencjonuj wymagane kroki w kodzie |
| Historia thinking | Podpisana do konwersacji i konta | Zachowaj bloki i stabilną historię |
| Zgodność z computer use | computer_20251124 odrzucone na Claude API / Google Cloud | Migruj do computer_toolset_20260801; zweryfikuj wsparcie gateway |
| Zgodność modeli advisor | Wcześniejsze pary advisor odrzucone | Wybierz wspierany advisor, np. Opus 5.5 |
Zmiany w thinking, wyborze narzędzi i odtwarzaniu historii wpływają na istniejące pętle agenta. Tabela podsumowuje te zmiany operacyjne; nie jest to pełny inwentarz funkcji.
Breaking Changes to Check
Sprawdź wszystkie pięć zmian niekompatybilnych: zastąp disabled dla thinking ustawieniem between_tools; usuń wymuszony wybór narzędzia; zachowaj kompatybilne bloki thinking i niezmienioną historię konwersacji; zmigruj z computer_20251124 na computer_toolset_20260801 w Claude API i Google Cloud; oraz zastąp niewspierane pary advisor. Amazon Bedrock nadal akceptuje computer_20251124. Niewspierani advisorzy obejmują Opus 4.8, 4.7, 4.6, Sonnet 5, Sonnet 4.6 i Haiku 5.5. Opus 5.5 to jedno z wspieranych zastępstw. Odczytuj bloki odpowiedzi według typu. Zweryfikuj zgodność platformy i gateway przed wdrożeniem. Oficjalny przewodnik migracji.
Additional Capabilities and Workflow Changes
Użyj oficjalnego przewodnika funkcji, aby przejrzeć postępy, effort per-message i sterowanie w trakcie konwersacji. Potwierdź wsparcie gateway przed włączeniem funkcji beta.
What Do You Need Before Using the Claude Sonnet 5.5 API?
- Konto CometAPI, klucz API, dostęp do modelu i dostępne środki rozliczeniowe.
- Terminal z cURL; Python i pip albo Node.js i npm do przykładów SDK.
- Wybrany endpoint:
/v1/messageslub/v1/chat/completions. COMETAPI_KEYzapisany w środowisku serwera oraz dostęp sieciowy dohttps://api.cometapi.com.- Krótki testowy prompt i jasne sprawdzenie użytecznego outputu, statusu ukończenia i zużycia tokenów.
How Do You Access Claude Sonnet 5.5 API Through CometAPI?
| Styl API | Endpoint | Najlepsze zastosowanie |
|---|---|---|
| Claude-native Messages API | POST /v1/messages | Narzędzia specyficzne dla Claude, sterowanie thinking, przepływy agenta, struktury odpowiedzi Anthropic |
| OpenAI-compatible Chat Completions | POST /v1/chat/completions | Istniejące projekty z OpenAI SDK, routery modeli, aplikacje wielomodelowe |
Wybierz Messages API, gdy zachowanie Claude ma znaczenie. Wybierz OpenAI-compatible API, gdy Twoja aplikacja już przełącza się między Claude, GPT, Gemini, DeepSeek lub innymi modelami przez tę samą warstwę abstrakcji.
Step 1: Store the API Key
Utwórz klucz w konsoli kluczy API CometAPI, a następnie ustaw go w środowisku wykonawczym.
Ustaw klucz CometAPI w powłoce POSIX
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
Ustaw klucz CometAPI w PowerShell
$env:COMETAPI_KEY="YOUR_COMETAPI_KEY"
Step 2: Make the First Messages Request
Wyślij pierwsze żądanie Messages zgodne z Anthropic
curl https://api.cometapi.com/v1/messages \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"messages": [{"role": "user", "content": "Explain exponential backoff in three bullet points."}]
}'
Sprawdź bloki content, stop_reason i usage, zanim dodasz więcej kontroli. Powyższa składnia cURL używa powłoki POSIX.
Step 3: Use the Anthropic Python SDK
Zainstaluj Anthropic Python SDK
pip install anthropic
Odczytaj bloki tekstowe i usage przy użyciu Anthropic SDK
import os
import anthropic
anthropic_client = anthropic.Anthropic(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com",
)
response = anthropic_client.messages.create(
model="claude-sonnet-5-5",
max_tokens=4096,
messages=[{"role": "user", "content": "Review this migration plan and list the three biggest risks."}],
)
for block in response.content:
if block.type == "text":
print(block.text)
print("Completion:", response.stop_reason)
print("Usage:", response.usage)
Step 4: Use the OpenAI Python SDK
Zainstaluj OpenAI Python SDK
pip install openai
Wywołaj Sonnet 5.5 przez OpenAI-compatible Chat Completions
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[
{
"role": "system",
"content": "You are a concise software engineering assistant."
},
{
"role": "user",
"content": "Review this function and identify the highest-risk bug."
}
],
)
print(response.choices[0].message.content)
To podejście jest użyteczne, gdy aplikacja już korzysta z interfejsu OpenAI SDK. Podstawowa integracja tekstowa może wymagać jedynie nowego base URL, klucza API i ID modelu, ale migracje produkcyjne nadal powinny zweryfikować wspierane parametry, formaty odpowiedzi, wywołania narzędzi, zdarzenia strumieniowe, limity czasu i rozliczanie tokenów.
Step 5: Use JavaScript in Node.js
Zainstaluj OpenAI Node.js SDK
npm install openai
Wywołaj Sonnet 5.5 z modułu ES w Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.COMETAPI_KEY,
baseURL: "https://api.cometapi.com/v1",
});
const response = await client.chat.completions.create({
model: "claude-sonnet-5-5",
messages: [
{
role: "user",
content: "Create a TypeScript function that validates an email address.",
},
],
});
console.log(response.choices[0].message.content);
Dla backendowych aplikacji Node.js trzymaj COMETAPI_KEY w środowisku serwera zamiast wysyłania go do klienta przeglądarkowego.
Claude Sonnet 5.5 Thinking and Effort Levels
API domyślnie używa high effort; aplikacje Claude i Claude Code używają medium. Wybierz effort w oparciu o jakość zaakceptowanych zadań, opóźnienie i koszt tokenów. Poniższa tabela to redakcyjny punkt wyjścia, nie oficjalna klasyfikacja obciążeń.
| Obciążenie | Sugerowany początkowy effort |
|---|---|
| Ekstrakcja | Low |
| Klasyfikacja | Low |
| Rutynowa odpowiedź wsparcia | Low lub Medium |
| Wyjaśnianie kodu | Medium |
| Naprawianie błędów | Medium |
| Kodowanie na poziomie repozytorium | High |
| Złożony przepływ agenta | High |
| Kosztowna recenzja produkcyjna | High, następnie porównaj z Opus |
| Wymagające, długofalowe kodowanie lub praca agenta | Xhigh, tylko gdy ewaluacja pokazuje wzrost jakości |
| Większość zadań wrażliwych na zdolności przy zaakceptowanym koszcie | Max, tylko gdy ewaluacja uzasadnia dodatkowe opóźnienie i tokeny |
Unikaj automatycznego ustawiania najwyższego effort dla każdego żądania. Przepływy agentów mogą stać się istotnie droższe, gdy dodatkowe rozumowanie generuje też więcej wywołań narzędzi i dłuższe outputy. Wybierz ustawienie na podstawie oceny na poziomie zadania. Użyj adaptive thinking dla Xhigh i Max, a następnie porównaj jakość zaakceptowanych zadań i całkowity koszt z niższymi poziomami. Oficjalne wskazówki dot. effort.
Configure Effort Through Messages
Ten przykład używa klienta Anthropic zainicjalizowanego powyżej. Przetestuj te same ustawienia na swojej trasie CometAPI przed wdrożeniem.
Skonfiguruj adaptive thinking i high effort
response = anthropic_client.messages.create(
model="claude-sonnet-5-5",
max_tokens=8192,
thinking={"type": "adaptive"},
output_config={"effort": "high"},
messages=[{"role": "user", "content": "Audit this service migration plan."}],
)
Turn Off Up-Front Thinking
Użyj thinking={"type": "between_tools"} przy low, medium lub high effort. Użyj adaptive thinking dla xhigh lub max. between_tools nie przyjmuje pól display ani budget_tokens i nie pozwala zmieniać effort w trakcie konwersacji.
Preserve Thinking in Tool Loops
Zwracaj oryginalne bloki treści asystenta przed dołączeniem wyników narzędzia. Zachowanie thinking zależy od modelu, prefiksu konwersacji i konta, które go tworzy. Wiązanie prefiksu jest domyślnie wymuszane w Claude API, Amazon Bedrock i Google Cloud dla kont utworzonych w dniu lub po 31 sierpnia 2026, 00:00 UTC. Nie zakładaj, że każdy gateway udostępnia te same mechanizmy wiązania.
How to Stream Claude Sonnet 5.5 Responses
Stream Long Responses
Strumieniowanie jest przydatne dla interfejsów czatu, asystentów kodowania i długich odpowiedzi, ponieważ użytkownicy mogą zobaczyć output przed zakończeniem generowania.
Strumieniuj tekst przez OpenAI-compatible Chat Completions
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1",
)
stream = client.chat.completions.create(
model="claude-sonnet-5-5",
messages=[
{
"role": "user",
"content": "Explain how a retrieval-augmented generation pipeline works."
}
],
stream=True,
)
for chunk in stream:
if not chunk.choices:
continue
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="", flush=True)
Strumieniowanie zazwyczaj nie zmniejsza całkowitej liczby wygenerowanych tokenów. Jego główną korzyścią jest postrzegane opóźnienie. Aplikacje powinny również jawnie obsługiwać przerwane strumienie, częściowe outputy, ponowne próby sieciowe i anulowanie.
Use Tools With Automatic Selection
Użyj tool_choice={"type": "auto"}. Waliduj każdą nazwę narzędzia i argument, stosuj autoryzację i limity czasu, zwracaj wyniki ustrukturyzowane i ograniczaj liczbę iteracji. Wykonanie wymaganych narzędzi należy do orkiestracji aplikacji.
Zdefiniuj narzędzie wyszukiwania zgłoszenia i poproś o automatyczny wybór
tools = [{
"name": "lookup_ticket",
"description": "Retrieve a support ticket by ID",
"input_schema": {
"type": "object",
"properties": {"ticket_id": {"type": "string"}},
"required": ["ticket_id"],
"additionalProperties": False,
},
}]
response = anthropic_client.messages.create(
model="claude-sonnet-5-5",
max_tokens=4096,
tools=tools,
tool_choice={"type": "auto"},
messages=[{"role": "user", "content": "Look up ticket T-123 and summarize its status."}],
)
Blok tool_use żąda akcji; to pierwsze wywołanie jej nie wykonuje. Zweryfikuj żądanie na swoim serwerze, uruchom operację, dołącz niezmienioną treść asystenta i wyślij pasujący tool_result. Schemat w tym przykładzie nadal wymaga walidacji po stronie aplikacji; ścisłe wsparcie narzędzi należy sprawdzić na wybranej trasie.
Use Prompt Caching for Repeated Context
Cache promptu jest przydatny, gdy żądania wielokrotnie zawierają ten sam duży prefiks, jak polityki systemowe, schematy narzędzi, mapy repozytoriów, dokumentacja produktu, wielokrotnego użytku instrukcje lub podręczniki referencyjne.
Sonnet 5.5 wymaga możliwego do zcache’owania prefiksu promptu co najmniej 512 tokenów. Krótsze prefiksy są przetwarzane bez cache, nawet przy cache_control. Sprawdź cache_creation_input_tokens i cache_read_input_tokens; oba jako zero oznaczają brak użycia cache. Potwierdź wsparcie na swojej trasie gateway. Referencja cache’owania promptów.
Ułóż stabilny kontekst przed dynamiczną treścią żądania
Stable system instructions
Stable tools
Stable repository or knowledge context
---------------- cache boundary ----------------
Current user request
Current retrieved context
Obecna stawka odczytu cache w CometAPI to $0.16 za milion tokenów, w porównaniu z $1.60 za świeży input. Zapisy cache są rozliczane osobno. Zweryfikuj trafienia cache w metadanych usage przed szacowaniem oszczędności.
Cache jest szczególnie użyteczny dla agentów kodujących i asystentów korporacyjnych, którzy ponownie używają dużych prefiksów kontekstu w wielu turach. Ekonomia nadal zależy od rzeczywistych trafień cache; częste przepisywanie stabilnego prefiksu może zniwelować oczekiwane korzyści.
Send Images Using the Selected Endpoint Schema
Sonnet 5.5 akceptuje input tekstowy i obrazowy. Poniższy JSON to payload kompatybilny z OpenAI Chat Completions; zamień przykładowy URL obrazu na publicznie dostępny obraz, który kontrolujesz. Messages używa innego schematu bloków obrazu.
Wyślij obraz w payloadzie Chat Completions
{
"model": "claude-sonnet-5-5",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "Find the three most important UI problems in this screenshot."
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/interface.png"
}
}
]
}
]
}
Dokładny kształt żądania multimodalnego może się różnić między interfejsem natywnym Claude a interfejsem kompatybilnym z OpenAI, więc używaj schematu odpowiadającego endpointowi, który faktycznie wdrażasz, zamiast zakładać ich zamienność.
Handle Safeguards and Retained Data
Rejestruj odmowy i zachowania awaryjne jako jawne stany aplikacji. Anthropic opisuje zabezpieczenia i dostępność zero-data-retention dla swojej usługi. Osobno zweryfikuj właściwe zasady retencji i routingu dla Twojego gateway przed wysłaniem materiałów produkcyjnych.
Claude Sonnet 5.5 vs Sonnet 5 vs Opus 5.5
Poniższe jakościowe etykiety to redakcyjne wskazówki routingu oparte na zakresie zadań, a nie oficjalne oceny wydajności. Zweryfikuj te role na reprezentatywnych obciążeniach. Szczegółowej architektury nie należy wnioskować na podstawie wyników benchmarków.
| Wymiar | Claude Sonnet 5 | Claude Sonnet 5.5 | Claude Opus 5.5 |
|---|---|---|---|
| Rutynowe kodowanie | Strong | Stronger and faster | Często niepotrzebny |
| Praca na repozytorium | Strong | Very strong | Najlepiej pasuje do trudniejszych przypadków |
| Dobrze zdefiniowani agenci | Strong | Primary fit | Przydatny dla trudniejszych przepływów |
| Niejasna, długotrwała praca | Good | Very good | Primary fit |
| Prędkość outputu | Baseline | 30%+ faster than Sonnet 5 | Bardziej zoptymalizowany pod zdolności niż tani throughput |
| Oficjalny input | $2/M | $2/M | $4/M |
| Oficjalny output | $10/M | $10/M | $20/M |
| Typowa rola produkcyjna | Istniejące obciążenia Sonnet | Domyślny kandydat Sonnet | Eskalacja / warstwa wysokiej złożoności |
| Okno kontekstu | 1M tokens | 1M tokens | 1M tokens |
| Input / output | Text and images / text | Text and images / text | Text and images / text |
| Thinking | Adaptive | Adaptive; between_tools at high or below | Adaptive, always on |
| Dostępność API | Istniejąca integracja CometAPI | CometAPI Messages i kompatybilne Chat Completions | Dostępny przez CometAPI |
Kieruj trudne zadania do modelu eskalacyjnego
Routine task
↓
Claude Sonnet 5.5
↓
Confidence / validation failure?
├── No → Return result
└── Yes → Escalate difficult case
↓
Opus-class model
Ten wzorzec routingu może obniżyć koszt, zapewniając jednocześnie dostęp do silniejszej warstwy rozumowania dla trudnych przypadków.
Claude Sonnet 5.5 Pricing Through CometAPI
| Rodzaj wyceny | Anthropic | CometAPI |
|---|---|---|
| Input | $2.00 / 1M tokens | $1.60 / 1M tokens |
| Output | $10.00 / 1M tokens | $8.00 / 1M tokens |
| Odczyt cache | $0.10 / 1M tokens | $0.16 / 1M tokens |
| Zapis cache (TTL 5 min) | $2.50 / 1M tokens | $2.00 / 1M tokens |
Sprawdzone 10 października 2026: w CometAPI input/output pozostają $1.60/$8 za milion tokenów, 20% poniżej $2/$10 w Anthropic. Odczyt/zapis cache w CometAPI to nadal $0.16/$2; bieżące stawki cache w Anthropic to $0.10/$2.50 dla zapisu z pięciominutowym TTL. Strona startowa wciąż pokazuje $0.20 za odczyty cache; ta rewizja używa bieżącej referencji cache’owania. Ceny gateway mogą zmieniać się niezależnie.
Różnica między ceną za token a kosztem zadania ma znaczenie dla aplikacji agentowych. Agent kodujący może wygenerować mniej tokenów, ale wciąż wykonać wiele rund wywołań narzędzi, odczytów cache, inspekcji kodu, ponowień i walidacji. Koszt na pomyślnie ukończone zadanie jest więc zwykle bardziej informacyjny niż sama cena za input token.
Oszacuj opłaty za świeży input i tokeny outputu
Input:
100,000 / 1,000,000 × $1.60 = $0.16
Output:
5,000 / 1,000,000 × $8.00 = $0.04
Estimated model-token cost:
$0.20
Opłaty za narzędzia, operacje cache, powtórzone kroki agenta lub inne funkcje płatne mogą zmienić końcowy koszt.
Stawki ponownie sprawdzone 10 października 2026 względem aktualnej strony modelu CometAPI. Ceny za świeży input/output są niezmienione, więc przykład obliczeniowy pozostaje $0.16 + $0.04 = $0.20 dla 100,000 świeżych input i 5,000 output tokenów. Nie obejmuje zapisów cache, odczytów cache, opłat za narzędzia ani ponowień. Przed budżetowaniem ponownie sprawdź rozliczanie specyficzne dla trasy.
Control Cost per Accepted Task
Istnieje kilka praktycznych sposobów ograniczania wydatków bez natychmiastowej zmiany modelu. Po pierwsze, jasno zdefiniuj kryteria ukończenia:
Zdefiniuj skupiony format akceptacji odpowiedzi
Return only:
1. the root cause;
2. the affected file;
3. the smallest safe fix;
4. one regression test.
Po drugie, przytnij kontekst pobrany przed jego wysłaniem. Okno kontekstu 1M tokenów to limit pojemności, a nie cel. Po trzecie, ponownie używaj stabilnego kontekstu poprzez cache promptów. Po czwarte, dobieraj effort do obciążenia zamiast ustawiania High dla każdego żądania. Po piąte, mierz koszt na zaakceptowane zadanie:
Oblicz koszt na zaakceptowane zadanie
Total API cost
÷
Number of outputs accepted without rework
Tańsze żądanie niekoniecznie oznacza tańszy przepływ, jeśli powoduje dodatkowe ponowienia, korekty lub wywołania narzędzi.
How Do You Migrate From Sonnet 5 to Claude Sonnet 5.5 API?
- Zachowaj poprzednią konfigurację produkcyjną do ewentualnego wycofania.
- Zmień ID modelu z claude-sonnet-5 na claude-sonnet-5-5.
- Zastosuj opisane powyżej zmiany w thinking, wyborze narzędzi i historii.
- Odtwórz reprezentatywne żądania, w tym narzędzia, obrazy i strumieniowanie.
- Porównaj zaakceptowane outputy, wskaźnik ludzkich korekt, opóźnienia p50/p95 i całkowity koszt zadania.
- Przetestuj ponowienia, odmowy, anulowania i przerwane strumienie.
- Zweryfikuj trafienia cache i zachowanie budżetu outputu w metadanych usage.
- Wypuść mały kanarek ruchu i zwiększaj go dopiero po spełnieniu progów akceptacji.
Troubleshooting Claude Sonnet 5.5 API Errors
| Objaw | Co sprawdzić |
|---|---|
| 400: invalid thinking setting | Zastąp disabled ustawieniem between_tools przy high lub niższym; użyj adaptive dla xhigh/max. |
| 400: forced tool selection | Usuń any lub wymuszenie nazw narzędzi; użyj auto. |
| 400 po odtworzeniu historii | Dla kont wymuszających wiązanie prefiksu utrzymaj niezmienione podpisane thinking i poprzedzającą historię; sprawdź zgodność modelu/konta i wybraną trasę. |
| 401 / 403 | Sprawdź poświadczenia, uprawnienia i dostęp do modelu. |
| 429 / retryable 5xx | Użyj ograniczonego exponential backoff z jitter i honoruj Retry-After, jeśli dostarczony. |
| Odpowiedź nie zawiera zwykłego tekstu | Sprawdź typy content, status ukończenia, odmowę i zachowanie awaryjne. |
| Output kończy się zbyt wcześnie | Sprawdź stop_reason lub finish_reason; dostosuj budżet outputu i użyj strumieniowania. |
| Cache nigdy nie trafia | Sprawdź stabilny prefiks i metadane użycia cache. |
| Rozłączenia strumienia | Zachowaj częściowy output i ponawiaj zgodnie z zasadami idempotencji aplikacji. |
Nie ponawiaj niepoprawnie sformatowanych żądań ani błędów uwierzytelnienia bez zmian. Zapobiegaj duplikowaniu akcji narzędzi podczas odtwarzania przerwanych przebiegów agenta.
Claude Sonnet 5.5 Production Best Practices
Wybierz obciążenie, zdefiniuj bramkę akceptacji i oceń kompletną aplikację. Loguj ID modelu, endpoint, effort, opóźnienie, zużycie tokenów i cache, awarie narzędzi, status ukończenia i wynik zaakceptowanego zadania. Przechowuj klucze po stronie serwera oraz skonfiguruj limity czasu, ograniczone ponowienia i limity iteracji agenta.
Measure Workflow Quality and Reliability
| Metryka | Dlaczego ma znaczenie |
|---|---|
| Wskaźnik sukcesu zadań | Mierzy faktyczną realizację przepływu |
| Wskaźnik korekt ręcznych | Ujawnia ukryte problemy jakościowe |
| Tokeny wejściowe | Kontrolują koszt kontekstu |
| Tokeny wyjściowe | Kontrolują koszt generowania |
| Wskaźnik trafień cache | Określa wartość cache’owania |
| Liczba wywołań narzędzi | Wykrywa nieefektywnych agentów |
| Nieprawidłowe wywołania narzędzi | Mierzy niezawodność orkiestracji |
| Wskaźnik ponowień | Ujawnia niestabilność API lub przepływu |
| Opóźnienie p50 | Typowe doświadczenie użytkownika |
| Opóźnienie p95 | Długie ogony doświadczenia użytkownika |
| Koszt na zaakceptowane zadanie | Łączy jakość i ekonomię |
Dla agentów kodujących śledź również liczbę zaliczonych testów, zbędnie modyfikowanych plików, wycofanych łatek i pomyślne ukończenia bez interwencji człowieka.
Example: Fix a Well-Scoped Repository Bug
Dostarcz test, który nie przechodzi, istotne pliki źródłowe i oczekiwane zachowanie. Poproś o skupioną łatkę z testem regresji. Bramka akceptacji to powtarzalna poprawka, przechodzące odpowiednie testy i brak niepowiązanych edycji. Porównaj łączny koszt API i narzędzi z zaakceptowanymi łatkami.
Example: Triage a Support Ticket
Pobierz problem klienta i zatwierdzone fragmenty bazy wiedzy. Poproś model o klasyfikację problemu, szkic odpowiedzi popartej dowodami i oznaczenie spraw wymagających eskalacji. Zaakceptuj wynik tylko wtedy, gdy jego twierdzenia odpowiadają pobranemu materiałowi, a decyzja routingu zgodna jest z polityką wsparcia.
Example: Review a Document and Screenshot
Dostarcz zatwierdzoną procedurę i zrzut ekranu odpowiadającego interfejsu. Poproś o rozbieżności z odniesieniami do odpowiedniego fragmentu i widocznego elementu UI. Wymagaj, by recenzent potwierdził ustalenia przed zmianą procedury.
Conclusion
Claude Sonnet 5.5 daje zespołom praktycznego kandydata do szybkiego kodowania, wsparcia, pracy z dokumentami i przepływów z użyciem narzędzi. Zacznij od działającego żądania w CometAPI, następnie dodaj kontrolki potrzebne Twojej aplikacji.
Migracja wymaga czegoś więcej niż zmiany ID modelu: sprawdź ustawienia thinking, automatyczny wybór narzędzi, parsowanie odpowiedzi i odtwarzanie historii. Promuj model, gdy ewaluacje Twoich obciążeń pokażą akceptowalną równowagę jakości, opóźnień i kosztu; zarezerwuj silniejszą warstwę dla zadań, które nie przejdą bramki akceptacji.
FAQ
How Should Teams Rotate a Claude Sonnet 5.5 API Key Without Downtime?
Przechowuj klucze w serwerowym menedżerze sekretów i pozwól workerom przeładowywać poświadczenia bez osadzania ich w kodzie aplikacji. Jeśli dostawca wspiera nakładające się aktywne klucze, najpierw wprowadź zamiennik, zweryfikuj małe żądanie, stopniowo przełączaj workery, a następnie unieważnij poprzedni klucz. Monitoruj błędy uwierzytelnienia podczas zmiany i unikaj logowania któregokolwiek klucza.
How Can a Claude Sonnet 5.5 Job Resume After a Worker Restart?
Utrwal identyfikator zadania, ostatni ukończony krok, konfigurację żądania i rejestry wykonania narzędzi. Wznów od zweryfikowanego punktu kontrolnego. Przed powtórzeniem akcji narzędzia sprawdź, czy już się zakończyła i czy bezpiecznie ją powtórzyć. Sam zapisany transkrypt nie zapobiega duplikatowi zgłoszeń, wiadomości ani zapisów w bazie danych.
How Should Teams Detect Claude Sonnet 5.5 Behavior Changes Over Time?
Utrzymuj datowany zestaw ewaluacyjny z zaakceptowanymi odpowiedziami lub kontrolami akceptacji, wraz z wersjami SDK i ustawieniami żądań. Uruchamiaj go okresowo oraz po zmianach u dostawcy, w SDK, w promptach lub w routingu. Porównuj sukces zadań, wskaźnik korekt, opóźnienia i całkowity koszt. Jeśli konto oferuje przypięcie wersji, potwierdź jego gwarancje, zanim na nim polegniesz; utrzymuj ścieżkę wycofania dla krytycznych przepływów.
