claude-opus-4-5-migration

Opus 4.5 Migrationsleitfaden

Einmalige Migration von Sonnet 4.0, Sonnet 4.5 oder Opus 4.1 zu Opus 4.5.

Migrationsworkflow

1. Durchsuche die Codebasis nach Modell-Strings und API-Aufrufen
2. Aktualisiere die Modell-Strings auf Opus 4.5 (siehe plattformspezifische Strings unten)
3. Entferne nicht unterstützte Beta-Header
4. Füge den effort-Parameter mit dem Wert "high" hinzu (siehe references/effort.md)
5. Fasse alle Änderungen zusammen
6. Teile dem Benutzer mit: „Wenn bei Opus 4.5 Probleme auftreten, lass es mich wissen – ich kann bei der Anpassung deiner Prompts helfen.“

Modell-String-Aktualisierungen

Ermittle, welche Plattform die Codebasis verwendet, und ersetze dann die Modell-Strings entsprechend.

Nicht unterstützte Beta-Header

Entferne den context-1m-2025-08-07 Beta-Header, falls vorhanden – er wird mit Opus 4.5 noch nicht unterstützt. Hinterlasse einen Kommentar, der darauf hinweist:

# Hinweis: 1M Kontext-Beta (context-1m-2025-08-07) wird mit Opus 4.5 noch nicht unterstützt

Ziel-Modell-Strings (Opus 4.5)

Plattform	Opus 4.5 Modell-String
Anthropic API (1P)	claude-opus-4-5-20251101
AWS Bedrock	anthropic.claude-opus-4-5-20251101-v1:0
Google Vertex AI	claude-opus-4-5@20251101
Azure AI Foundry	claude-opus-4-5-20251101

Quell-Modell-Strings zum Ersetzen

Quell-Modell	Anthropic API (1P)	AWS Bedrock	Google Vertex AI
Sonnet 4.0	claude-sonnet-4-20250514	anthropic.claude-sonnet-4-20250514-v1:0	claude-sonnet-4@20250514
Sonnet 4.5	claude-sonnet-4-5-20250929	anthropic.claude-sonnet-4-5-20250929-v1:0	claude-sonnet-4-5@20250929
Opus 4.1	claude-opus-4-1-20250422	anthropic.claude-opus-4-1-20250422-v1:0	claude-opus-4-1@20250422

NICHT migrieren: Alle Haiku-Modelle (z. B. claude-haiku-4-5-20251001).

Prompt-Anpassungen

Opus 4.5 weist bekannte Verhaltensunterschiede zu früheren Modellen auf. Wende diese Korrekturen nur an, wenn der Benutzer sie explizit anfordert oder ein spezifisches Problem meldet. Standardmäßig werden nur die Modell-Strings aktualisiert.

Integrationsrichtlinien: Füge Snippets nicht einfach an Prompts an. Integriere sie durchdacht:

• Verwende XML-Tags (z. B. <code_guidelines>, <tool_usage>), um Ergänzungen zu organisieren
• Passe den Stil und die Struktur des vorhandenen Prompts an
• Platziere Snippets an logischen Stellen (z. B. Codierungsrichtlinien in der Nähe anderer Codierungsanweisungen)
• Wenn der Prompt bereits XML-Tags verwendet, füge neuen Inhalt in geeignete vorhandene Tags ein oder erstelle konsistente neue

1. Tool-Überauslösung

Opus 4.5 reagiert empfindlicher auf System-Prompts. Aggressive Formulierungen, die bei früheren Modellen eine Unterauslösung verhinderten, können jetzt zu einer Überauslösung führen.

Anwenden wenn: Der Benutzer meldet, dass Tools zu häufig oder unnötig aufgerufen werden.

Finde und entschärfe:

• KRITISCH: → entfernen oder abschwächen
• Du MUSST... → Du solltest...
• IMMER mache X → Mache X
• NIEMALS überspringen... → Nicht überspringen...
• ERFORDERLICH → entfernen oder abschwächen

Wende dies nur auf tool-auslösende Anweisungen an. Andere Hervorhebungen unverändert lassen.

2. Verhinderung von Over-Engineering

Opus 4.5 neigt dazu, zusätzliche Dateien zu erstellen, unnötige Abstraktionen hinzuzufügen oder ungefragte Flexibilität einzubauen.

Anwenden wenn: Der Benutzer unerwünschte Dateien, übermäßige Abstraktion oder nicht angeforderte Funktionen meldet. Füge das Snippet aus references/prompt-snippets.md hinzu.

3. Code-Erkundung

Opus 4.5 kann bei der Code-Erkundung übermäßig konservativ sein und Lösungen vorschlagen, ohne Dateien zu lesen.

Anwenden wenn: Der Benutzer meldet, dass das Modell Korrekturen vorschlägt, ohne den relevanten Code zu inspizieren. Füge das Snippet aus references/prompt-snippets.md hinzu.

4. Frontend-Design

Anwenden wenn: Der Benutzer eine verbesserte Frontend-Designqualität anfordert oder generisch aussehende Ausgaben meldet.

Füge das Frontend-Ästhetik-Snippet aus references/prompt-snippets.md hinzu.

5. Denkempfindlichkeit

Wenn erweitertes Denken nicht aktiviert ist (Standard), reagiert Opus 4.5 besonders empfindlich auf das Wort „denken“ und seine Varianten. Erweitertes Denken ist nur aktiviert, wenn die API-Anfrage einen thinking-Parameter enthält.

Anwenden wenn: Der Benutzer Probleme im Zusammenhang mit „denken“ meldet, während erweitertes Denken nicht aktiviert ist (kein thinking-Parameter in der Anfrage).

Ersetze „denken“ durch Alternativen wie „erwägen“, „glauben“ oder „bewerten“.

Referenz

Siehe references/prompt-snippets.md für den vollständigen Text jedes hinzuzufügenden Snippets.

Siehe references/effort.md zur Konfiguration des effort-Parameters (nur auf Benutzerwunsch).