Claude-Code-Anleitung — tägliche Nutzung mit einem nutzungsbasierten API-Schlüssel: Modelle wechseln, Kosten berechnen, Kontext verwalten

Die Verwendung von Claude Code lässt sich in vier Schritte zusammenfassen: Führe im Projektordner claude aus, starte einmal /init, damit CLAUDE.md erstellt wird, beschreibe die Aufgabe auf Deutsch mit Dateipfad und prüfe die vorgeschlagenen Änderungen, bevor du sie annimmst. Es ist ein Programmierassistent im Terminal, der Dateien liest und bearbeitet sowie Tests ausführt und vorher deine Zustimmung einholt. Du kannst dich mit einem Pro-/Max-Abonnement anmelden oder einen nutzungsabhängigen API-Schlüssel konfigurieren. Bei Verwendung eines Schlüssels wird jeder Schritt nach Token abgerechnet; im Alltag sind daher drei Dinge wichtig: je nach Aufgabe das Modell wechseln, die Kosten einer Sitzung kennen und den Kontext kompakt halten.

Fast alle Claude-Code-Anleitungen im Internet setzen eine Anmeldung per Abonnement voraus. Diese Seite richtet sich an eine andere Gruppe: Personen ohne Abonnement oder an diejenigen, die nicht durch ein 5-Stunden-Nutzungsfenster eingeschränkt werden möchten und stattdessen einen nutzungsabhängigen Schlüssel verwenden. Wenn Claude Code noch nicht installiert ist, lies zuerst Claude-Code-Installationsanleitung und kehre nach der Installation und Verbindung hierher zurück.

Der erste Einstieg: vier Aktionen

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

Vor jeder Dateiänderung und jedem Befehl fragt es dich. Wenn die Richtung falsch ist, drücke Esc zum Anhalten und kehre mit /rewind zum vorherigen Prüfpunkt zurück; Code und Unterhaltung werden gemeinsam zurückgesetzt. Das von /init erzeugte CLAUDE.md ist nur ein Entwurf. Weiter unten gibt es einen eigenen Abschnitt dazu, wie du es kürzer machst.

Abrechnung einer Sitzung bei Verwendung eines API-Schlüssels

Bei jeder Anfrage sendet Claude Code System-Prompt, CLAUDE.md, die gesamte Unterhaltung und den Inhalt gelesener Dateien erneut; neue Inhalte werden am Ende angefügt. Der unveränderte Anfang wird aus dem Cache gelesen: Cache-Lesen kostet 10 % des Eingabepreises, Cache-Schreiben das 1,25-Fache des Eingabepreises. Der größte Teil der Kosten einer Sitzung entsteht daher oft durch das erneute Lesen alter Unterhaltungen.

Die folgende Tabelle verwendet eine Sitzung aus Anthropic’s offizieller Kosten-Dokumentation – 1.200 Eingabe-, 5.300 Ausgabe-, 940.000 Cache-Lese- und 50.000 Cache-Schreib-Token – und berechnet sie mit den Kunavo-Tarifen für jedes der vier Modelle:

Bei Claude Sonnet 5 entfallen bei dieser Sitzung etwa 85% der Rechnung auf Cache-Lese- und -Schreibvorgänge. Anders gesagt: Die Kosten werden durch die Länge der Unterhaltung bestimmt, nicht durch die Zahl der eingegebenen Zeichen – deshalb geht es im folgenden Abschnitt um „Kontexthygiene“.

Um deine eigenen Zahlen zu sehen, führe in Claude Code /usage aus (/cost ist der Alias); dadurch werden diese vier Tokenarten angezeigt. Der danebenstehende Betrag wird jedoch von Claude Code lokal anhand der Anthropic-Preise geschätzt. Bei Kunavo gilt für die tatsächliche Belastung die Nutzungsseite im Dashboard; dort stehen die Tokenzahlen einschließlich Cache-Lese- und -Schreibvorgängen sowie die Belastung je Modell.

Modell je nach Aufgabe wechseln

Ordnen Sie zunächst im ~/.claude/settings.json-Abschnitt von env jeden Alias dem tatsächlichen Modell zu. Wenn Sie dies in diese Datei schreiben, können auch die Editor-Erweiterung und Hintergrundprozesse darauf zugreifen; schreiben Sie es nicht in .claude/settings.json, das im Projekt committet wird. Die Zuordnung der Aliase ist zwingend: Das Standardmodell von Claude Code und der Alias opus verweisen beide auf das neueste Opus. Wenn Kunavo es noch nicht anbietet, führt eine fehlende Zuordnung bereits beim ersten Request zu 404; der Alias sonnet verweist dagegen auf Sonnet 5.5, das Kunavo nicht anbietet. Ohne ANTHROPIC_DEFAULT_SONNET_MODEL erhalten /model sonnet, die Ausführungsphase von opusplan und Subagenten mit model: sonnet alle 404. Die folgende Konfiguration ordnet den Alias opus Claude Opus 5.5 (claude-opus-5-5) zu und erfordert Claude Code v2.1.280 oder höher; bei einer älteren Version führen Sie zuerst claude update aus.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

Nach der Einrichtung genügt eine Zeile zum Wechseln:

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/model speichert die Auswahl als Standard für spätere Sitzungen. Für einen einmaligen Wechsel führe /model ohne Parameter aus und drücke im Menü s. ANTHROPIC_DEFAULT_HAIKU_MODEL steuert außerdem die von Claude Code im Hintergrund erstellten Zusammenfassungen und Titel. Das günstigste Modell dafür zu verwenden, ist die wirtschaftlichste Einstellung.

Bei Kunavo kostet Claude Opus 5.5 $2.80 / $14.00, und Claude Sonnet 5 kostet $1.40 / $7.00; der Einzelpreis von Claude Haiku 4.5 beträgt etwa 1/2 von Claude Sonnet 5, während Claude Fable 5 das 5-Fache davon kostet. Im Vergleich zur offiziellen Preisgestaltung: Claude Sonnet 5 Etwa 30% günstiger als der offizielle Anthropic-Preis, Claude Opus 5.5 Etwa 30% günstiger als der offizielle Anthropic-Preis, Claude Haiku 4.5 Etwa 30% günstiger als der offizielle Anthropic-Preis, Claude Fable 5 Etwa 30% günstiger als der offizielle Anthropic-Preis.

Wechsle zwischen Aufgaben das Modell, nicht mitten in einer Aufgabe. Der Cache jedes Modells ist getrennt: Wenn du mitten in der Aufgabe /model wechselst, muss die nächste Anfrage die gesamte Unterhaltung zu einem nicht gecachten Preis erneut lesen (solange der Cache gültig ist, bittet Claude Code zuerst um Bestätigung). Führe zuerst /clear aus und wechsle dann; dann muss nur die kurze neue Unterhaltung erneut gelesen werden. Reasoning-Token werden zum Ausgabepreis berechnet. Für einfache Aufgaben kannst du mit /effort die Denktiefe reduzieren – ebenfalls am Anfang der Aufgabe; bei den meisten Modellen macht eine Änderung von effort in der Mitte den Cache ungültig.

CLAUDE.md: Nur Dinge, die du wiederholt erklären würdest

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.md wird am Anfang jeder Sitzung geladen und anschließend mit jeder Anfrage gesendet, meist zum Cache-Lesepreis. Anthropic empfiehlt höchstens 200 Zeilen pro Datei – je länger sie ist, desto mehr Kontext verbraucht sie und desto schlechter wird sie befolgt. Dinge, die aus dem Code hervorgehen (Verzeichnisstruktur, Funktionsbeschreibungen), gehören nicht hinein. Notizen, die nur für Menschen bestimmt sind, kannst du in <!-- --> einschließen; sie werden vor dem Senden in den Kontext entfernt.

Ein weiterer häufiger Irrtum: Eine Änderung von CLAUDE.md während einer Sitzung wird nicht sofort wirksam. Die neue Version wird erst nach /clear, /compact oder einem Neustart gelesen.

Kontexthygiene: jeden Schritt günstig halten

• Verwende zwischen nicht verwandten Aufgaben /clear. Dadurch wird eine neue Unterhaltung gestartet, die selbst nichts kostet; die alte kannst du später mit /resume wiederherstellen.
• Wenn dieselbe Aufgabe zu lang wird, verwende /compact. Du kannst angeben, welche Punkte erhalten bleiben sollen, zum Beispiel /compact 保留測試輸出和改過的檔案. Dabei wird eine Zusammenfassungsanfrage gesendet; solange der Cache gültig ist, ist sie am günstigsten. Wenn du erst nach längerer Abwesenheit compact verwendest, muss die gesamte Historie zum nicht gecachten Preis erneut gelesen werden.
• Wenn du in die falsche Richtung gehst, verwende /rewind. Zurückgesetzt wird der bereits gecachte Anfang, was günstiger ist als compact.
• Im Schlüsselmodus bleibt der Cache standardmäßig nur 5 Minuten erhalten. Wenn du länger als 5 Minuten weg bist, wird beim ersten Schritt der gesamte vorherige Kontext erneut in den Cache geschrieben (zum 1,25-fachen Eingabepreis). Bevor du zu einer Besprechung oder zum Essen gehst, beende mit /compact oder /clear.
• Verwende /context, um zu sehen, was Kontext belegt. Bei Kunavo ist diese Zahl eine lokale Schätzung. Kunavo bietet derzeit kein /v1/messages/count_tokens; die automatische Verdichtung und die Sitzung selbst bleiben davon unberührt.
• Deaktiviere nicht benötigte MCP-Server in /mcp. In der Dokumentation von Anthropic steht, dass ein eigener ANTHROPIC_BASE_URL die Tool-Suche (tool search) deaktiviert. MCP-Tooldefinitionen werden dann nicht verzögert geladen, sondern belegen jede Anfrage direkt.
• Füge bei der Aufgabenbeschreibung den Dateipfad hinzu. „Ändere die Validierung“ führt dazu, dass viele Dateien durchsucht und gelesen werden; „Ändere die Validierung in src/api/user.ts so, dass sie zod verwendet“ liest nur das Nötige.

Wenn Claude Code weniger oft fragen soll „Darf ich das ausführen?“, erlaube am besten nur Befehle zum Lesen und Validieren. Ein Flag, das alle Bestätigungen überspringt, sollte nur in einer Umgebung verwendet werden, die vollständig weggeworfen werden kann. Die Begründung steht in der Erklärung zu --dangerously-skip-permissions (Englisch). Informationen zur Cache-Abrechnung findest du in der Cache-Dokumentation.

Kostenlimits und Zahlung

Erstelle auf der Schlüsselverwaltungsseite einen eigenen Schlüssel für Claude Code und lege ein monatliches Kostenlimit fest. Sobald das Limit erreicht ist, geben Anfragen dieses Schlüssels 402 zurück, es wird nichts weiter berechnet und eine außer Kontrolle geratene Schleife kann nur bis zum Limit Kosten verursachen. Auf derselben Seite kannst du eine IP-Zulassungsliste festlegen.

Das Konto funktioniert auf Vorauszahlungsbasis: Mindestaufladung $10, das Guthaben verfällt nicht und fehlgeschlagene Requests werden nicht berechnet. In Taiwan können Sie mit internationalen Kreditkarten (Visa, Mastercard, Amex, JCB, UnionPay) oder Apple Pay und Google Pay aufladen; lokale Zahlungswege wie Jko und LINE Pay werden derzeit nicht unterstützt. Einzelheiten finden Sie unter Claude-Code-Kosten.

Wann sich ein Abonnement eher lohnt

Für Personen, die täglich lange interagieren und monatlich viele Schritte ausführen, ist die feste Monatsgebühr eines Abonnements normalerweise günstiger als die nutzungsabhängige Abrechnung. Eine einzige Division genügt: Monatsgebühr ÷ Kosten pro Schritt = Break-even-Anzahl von Schritten. Bei etwa $0.043 pro Schritt mit Claude Sonnet 5 (ohne Cache) ist Pay-as-you-go günstiger, wenn du monatlich weniger Schritte ausführst; Monate ohne Arbeit kosten $0. Die aktuellen Monatsgebühren und vollständigen Berechnungen aller Tarife stehen auf der Seite Claude-Code-Kosten; hier wiederholen wir sie nicht.

Auch die Abwägung dieses Weges sollte klar sein: Bei Kunavo verwendest du gemeinsam genutzte Kapazität ohne dediziertes Kontingent und ohne vertragliche SLA. Teams, die garantierte Kontingente oder eine SLA benötigen, sollten direkt bei Anthropic einkaufen. Eine vollständige Beschreibung der Verbindungseinstellungen findest du in der Claude-Code-Integrationsdokumentation (Englisch).

Häufig gestellte Fragen