Es gibt viele Artikel, die die Verwendung von Claude Code erklären, aber die meisten enden bei „installieren und den ersten Lauf ausführen“. Die eigentlichen Probleme beginnen danach — dieselben Anweisungen jedes Mal schreiben, zu viele Bestätigungsdialoge und mitten in der Arbeit das 5-Stunden-Nutzungslimit erreichen. Diese Seite beginnt dort, wo Einführungsartikel enden, und arbeitet diese drei Punkte nacheinander ab.
Grundsätzlich ist Claude Code kein „Tool, in das man Code in den Chat einfügt“, sondern ein Agent, der im Terminal innerhalb des Repositorys lebt. Er liest Dateien, ändert sie, führt Tests aus und erstellt sogar Commits. Deshalb sollten Sie zunächst nicht die Bedienung lernen, sondern dem Agenten die Projektregeln geben.
Die ersten 3 Schritte — Starten, /init, konkreter Auftrag
Direkt nach der Installation lohnen sich nur diese 3 Schritte. Besonders wenn Sie den zweiten Schritt /init überspringen, müssen Sie in allen folgenden Sitzungen dieselben Erklärungen wiederholen.
# 1. プロジェクトのディレクトリで起動する（ここが全ての前提）
cd ~/work/my-app
claude
# 2. 最初の一手は /init — リポジトリを読んで CLAUDE.md を書き出す
> /init
# 3. 以降は普通の日本語で頼む。ファイル名を添えるほど精度が上がる
> src/api/user.ts のバリデーションを zod に置き換えて、テストも直して/init liest das Repository und erzeugt CLAUDE.md. Der erzeugte Inhalt ist nur ein Entwurf; belassen Sie es nicht dabei, sondern korrigieren Sie ihn unbedingt von Hand. Im nächsten Abschnitt geht es um den Inhalt.
CLAUDE.md — Alles, was Sie jedes Mal erklären, einmalig festhalten
CLAUDE.md ist eine Markdown-Datei im Projektstamm, die bei jeder Sitzung automatisch eingelesen wird. Hineingehört nur „was sich nicht durch Lesen des Codes erschließt“.
# CLAUDE.md — プロジェクトのルート、git にコミットする
## コマンド
- テスト: npm test（1 ファイルだけなら npm test -- path/to/file）
- 型チェック: npx tsc --noEmit
- Lint: npm run lint
## 決めごと
- 日付は必ず date-fns。moment は使わない。
- API ハンドラは app/api/**/route.ts のみ。lib に書かない。
- コミットメッセージは日本語、prefix は feat / fix / docs。
## 触ってはいけない場所
- db/migrations/ — 生成物。手で編集しない。Ebenso klar ist, was Sie besser nicht hineinschreiben. Verzeichnisstrukturen und Funktionsbeschreibungen sind beim Lesen des Codes ersichtlich und daher überflüssig. Da CLAUDE.md bei jeder Anfrage mitgesendet wird, verbraucht eine lange Datei zuverlässig Tokens — kurz halten und nur Regeln aufnehmen. Nach einem Commit in git gelten dieselben Regeln für das gesamte Team.
Berechtigungen — Rückfragen reduzieren, aber nicht zu viel überspringen
Bei jeder Änderung einer Datei und jeder Befehlsausführung wird eine Bestätigung verlangt. Das ist eine Sicherheitsvorkehrung; praktisch ist daher nicht, alles zu entfernen, sondern „nur Lese- und Prüfaktionen zu erlauben“. Wenn Sie während der Sitzung „Immer erlauben“ auswählen, wird die Einstellung gespeichert; in .claude/settings.json können Sie sie auf Projektebene festlegen.
Es gibt auch ein Flag, das alle Bestätigungen überspringt; dann sind sogar Löschungen und Pushes ins Remote unbestätigt. Verwenden Sie es nur in Containern oder temporären Arbeitsbäumen, die Sie bei einer Beschädigung wegwerfen können. Entscheidungskriterien und sichere Verwendung sind unter Wann --dangerously-skip-permissions eingesetzt werden sollte zusammengefasst.
Benutzerdefinierte Befehle — nicht jedes Mal dieselbe Bitte formulieren
Aufgaben, bei denen Sie fast jedes Mal dieselbe Bitte formulieren, etwa Reviews, Prüfungen vor einem Release oder das Formatieren von Commit-Nachrichten, können Sie in Befehle umwandeln. Legen Sie dazu einfach Markdown unter .claude/commands/ ab.
# .claude/commands/review.md — 置くだけで /review として使える
指定されたファイルをレビューして、次の 3 点だけ指摘してください。
1. 実際に落ちる条件があるバグ（再現手順を添える）
2. 既存のユーティリティで置き換えられる重複
3. テストが無い分岐
スタイルの好みは指摘しないでください。Wenn Sie dann /review src/api/user.ts eingeben, erhalten Sie ein Review nach denselben Kriterien. Durch einen Commit in git kann das Team den Befehl gemeinsam verwenden und die Review-Standards selbst im Repository ablegen. Praktische Befehlsmuster sind ausführlich auf Englisch unter Claude Code workflows beschrieben.
So arbeiten Sie weiter, wenn das 5-Stunden-Fenster geschlossen ist
Das Nutzungskontingent des Abonnements wird in einem rollierenden 5-Stunden-Fenster verwaltet und kann sich an einem produktiven Nachmittag schließen. Auch ein Wechsel zu einem höheren Tarif öffnet es nicht sofort. Im Wesentlichen gibt es 3 Möglichkeiten.
| Option | Geeignete Situation |
|---|---|
| Warten, bis sich das Fenster öffnet | Keine Deadline; einige Stunden Aufschub möglich |
| Auf einen höheren Tarif wechseln | Passiert täglich. Das Kontingent reicht dauerhaft nicht aus |
| Nur für diese Arbeit zu einem API-Schlüssel wechseln | Heute fertig werden müssen; Limit nur einige Male pro Monat erreicht |
Die dritte Möglichkeit funktioniert, ohne das Abonnement zu kündigen. Nur solange die folgenden 2 Zeilen gesetzt sind, gilt nutzungsabhängige Abrechnung; löschen Sie die Variablen, kehren Sie zum ursprünglichen Abonnement zurück.
# 5 時間ウィンドウが閉じても作業を続けるための 2 行。
# この変数が設定されている間だけ従量課金になり、消せば元のサブスクに戻る。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Claude Code の既定モデルと opus エイリアスは最新の Opus を、sonnet エイリアスは
# Kunavo が提供していない Sonnet 5.5 を指す。/model sonnet や opusplan の実行
# フェーズ、sonnet 指定のサブエージェントが 404 にならないようモデルを固定する。
# opus は Opus 5.5 に固定（Claude Code v2.1.280 以降が必要。古ければ claude update）。
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
# 補助的な処理を一番安いモデルに逃がす 1 行（毎セッション効く）
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5Die Tarife werden direkt aus dem Katalog geladen: Claude Sonnet 5 kostet pro 1M Tokens $1,40 / $7,00, Claude Haiku 4.5 kostet $0,70 / $3,50. Der Betrag wird vom Guthaben im Vorauszahlungskonto abgezogen, daher beträgt die Rechnung in Monaten ohne Nutzung 0. Ob das Abonnement oder die nutzungsabhängige Abrechnung günstiger ist, einschließlich der tatsächlichen Kosten pro Schritt und des Break-even-Punkts, berechnen wir unter Claude Code-Preise. Wie das Fenster selbst funktioniert, erfahren Sie unter Claude Pro-Limits; welches Modell standardmäßig verwendet werden sollte, unter Unterschiede zwischen Opus und Sonnet.
Wie Sie Anfragen formulieren, die die Genauigkeit erhöhen oder senken
Hier zeigt sich die Qualität der Bedienung am deutlichsten. Wenn Sie Dateinamen und Pfade angeben, werden weniger Tokens für die Suche benötigt und das Ergebnis ist schneller und genauer — „Behebe die Validierung“ statt „Ersetze die Validierung in src/api/user.ts durch zod“.
Senden Sie außerdem keinen großen Auftrag in einem Schritt. Wenn Sie ihn in Änderung → Test → nächste Änderung aufteilen, ist auch nach einem Fehler klar, wohin Sie zurückkehren. Die Fehleranalyse ist auf einzelnen Seiten wie Claude Code: 401-Fehler zusammengefasst.
Wenn Sie dieselbe Vorgehensweise mit einem Agenten auf der OpenAI-Seite ausprobieren möchten, finden Sie unter Verwendung von Codex eine Anleitung, wie Sie es ohne ChatGPT-Tarif mit einem API-Schlüssel betreiben.
Häufig gestellte Fragen
Was sollte ich bei der Verwendung von Claude Code zuerst tun?
Starten Sie claude im Projektverzeichnis und führen Sie zunächst /init aus. /init liest das Repository und erzeugt CLAUDE.md. Darin werden die Regeln des Projekts festgehalten (wie Tests ausgeführt werden, welche Bibliotheken verwendet werden und welche Dateien nicht angefasst werden dürfen); die Datei wird anschließend in jeder Sitzung automatisch eingelesen. Wenn Sie ohne diese Datei beginnen, müssen Sie dieselben Anweisungen jedes Mal erneut eingeben.
Was sollte in CLAUDE.md stehen?
Schreiben Sie nur hinein, was Sie jedes Mal erklären. Konkret sind das drei Dinge: die Befehle für Tests und Typprüfung, projektspezifische Regeln (diese Datumsbibliothek verwenden, keine Logik in diese Schicht legen) und die Pfade zu generierten Dateien, die nicht angefasst werden dürfen. Was sich beim Lesen des Codes erschließt, gehört dagegen nicht hinein. Eine lange CLAUDE.md wird bei jeder Anfrage mitgesendet, verursacht also zuverlässig Kosten, ohne die Genauigkeit zu erhöhen.
Was soll ich tun, wenn ich das 5-Stunden-Nutzungslimit erreiche?
Es gibt drei Möglichkeiten: warten, bis sich das Fenster öffnet, auf einen höheren Tarif wechseln oder nur für diese Arbeit zu einem API-Schlüssel wechseln. Für die dritte Möglichkeit müssen Sie lediglich ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN setzen; das Abonnement muss nicht gekündigt werden. Solange die Variablen gesetzt sind, gilt Token-basierte Abrechnung; löschen Sie sie, kehren Sie zum vorherigen Zustand zurück. Wenn Sie die Arbeit nicht unterbrechen möchten, ist dies der schnellste Weg.
Kann ich reduzieren, wie oft ich gefragt werde, ob etwas ausgeführt werden darf?
Ja. Wenn Sie während der Sitzung „Immer erlauben“ auswählen, wird die Einstellung gespeichert; in .claude/settings.json können Sie sie auf Projektebene festlegen. Wenn Sie Befehle zum Lesen und Prüfen wie npm test oder git status erlauben, sinkt die Zahl der Rückfragen deutlich. Es gibt auch ein Flag, das alle Bestätigungen überspringt; verwenden Sie es jedoch außerhalb isolierter Umgebungen nicht — dann wären auch Löschungen und Pushes unbestätigt.
Wie erstelle ich benutzerdefinierte Befehle?
Legen Sie einfach eine Markdown-Datei unter .claude/commands/ ab. Wenn Sie review.md anlegen, können Sie sie als /review verwenden. Der Inhalt darf ein Prompt in natürlicher Sprache sein. Wenn Sie die Datei in git committen, kann das gesamte Team denselben Befehl verwenden und Aufgaben teilen, für die man „jedes Mal dasselbe bittet“, etwa Review-Kriterien oder Release-Abläufe.
Welcher Tipp hilft am meisten, um die Verwendung zu lernen?
Geben Sie konkrete Dateinamen und Pfade an. „Behebe die Validierung“ ist weniger hilfreich als „Ersetze die Validierung in src/api/user.ts durch zod“; dadurch werden weniger Tokens für die Suche benötigt und das Ergebnis ist schneller und genauer. Teilen Sie außerdem große Aufträge auf, statt sie in einem Schritt zu senden: Änderung → Test → nächste Änderung. So ist bei einem Fehler klar, wohin Sie zurückkehren können.