Tutorial

Offizielles Claude Agent SDK: ehrlicher, prüfbarer Personal Assistant (2026)

MacLogin KI-Automatisierungsteam 1. Juni 2026 ~12 Min.

Mit dem Claude Agent SDK von Anthropic binden Sie dieselbe Tool-Schleife wie Claude Code in Ihre eigene Python- oder TypeScript-App ein. Einsteigerregel: zuerst nur Lesen, einen Ehrlichkeits-system_prompt setzen, dann allowed_tools erst erweitern, wenn die Audit-Logs stimmen.

Siehe auch: Claude Code per SSH, Cursor Rules vs. Skills, Opus-4.8-Agent-Benchmarks.

Hinweis: MacLogin veröffentlicht diesen Leitfaden. Folgen Sie der offiziellen Agent-SDK-Dokumentation und nutzen Sie einen Claude Console-API-Schlüssel — kein Weiterverkauf von claude.ai-Logins in Drittanbieter-Apps.

Warum mit dem offiziellen SDK starten

Wrapper verbergen oft, welche Tools laufen und was Ihre Maschine verlässt. Das SDK dokumentiert Read, Edit, Bash, permissions, hooks und sessions auf code.claude.com.

Ein Cloud-Mac ist für 24/7-Zeitpläne optional; für den ersten abgesicherten Helfer reicht Ihr Laptop.

Aufbau des SDK

Schicht	Rolle	Sie konfigurieren
`query()`	Agent-Schleife (Plan → Tool → Beobachtung)	`agent.py`
Tools	Datei, Shell, Suche, Web	`allowed_tools`
Permissions	Erlauben / ablehnen / nachfragen	`permission_mode`
Policy	Ehrlichkeit, Umfang	`system_prompt`, `CLAUDE.md`
Audit	Tool-Nutzung protokollieren	`hooks`

Ab dem 15. Juni 2026 messen Abopläne das Agent SDK über einen separaten Credit-Pool — budgetieren Sie unbeaufsichtigte Schleifen.

Acht-Schritte-Runbook mit Schutz

Schritt 1 — Voraussetzungen

python3 --version   # 3.10+
pip install claude-agent-sdk

Schritte 2–3 — Projekt + Installation

mkdir my-guarded-agent && cd my-guarded-agent
python3 -m venv .venv && source .venv/bin/activate
pip install claude-agent-sdk

Schritt 4 — API-Schlüssel

# .env (gitignore this file)
ANTHROPIC_API_KEY=sk-ant-...

Schritte 5–6 — Ehrlichkeits-Prompt + Nur-Lesen-Lauf

from claude_agent_sdk import query, ClaudeAgentOptions

HONEST = """Say "I don't know" when data is missing.
Never invent paths or command output."""

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Glob", "Grep"],
    permission_mode="dontAsk",
    system_prompt=HONEST,
)

Ausführen: python3 agent.py — laut quickstart.

Schritte 7–8 — Audit-Hook, dann Bearbeitungen

Fügen Sie PostToolUse-Hooks für audit.log hinzu, bevor Sie Edit mit permission_mode="acceptEdits" aktivieren. Optional: AskUserQuestion zur Klärung.

Fehlerbehebung

API-Schlüssel nicht gefunden

Fix: ANTHROPIC_API_KEY in derselben Shell exportieren; .env nie committen.

pip: No matching distribution

Fix: Python 3.10+ verwenden; .venv neu anlegen.

thinking.type.enabled not supported

Fix: Agent SDK auf v0.2.111+ für Opus 4.7+ aktualisieren ([quickstart](https://code.claude.com/docs/en/agent-sdk/quickstart)).

Unerwartete Dateibearbeitungen

Fix: Mit git zurücksetzen; bis Hooks sicher sind wieder dontAsk und Nur-Lesen-Tools.

FAQ

Agent SDK vs. Claude Code?

Claude Code ist die interaktive App; das SDK ist eine Bibliothek mit query() und ClaudeAgentOptions.

Sicherster permission_mode?

dontAsk nur mit Read, Glob, Grep.

Opus 4.8 nutzen?

Ja — Modell in den Options setzen. Lokale Tool-Allowlists weiter erzwingen; siehe Benchmark-Leitfaden.

MacLogin nötig?

Nein — nur API-Schlüssel. Remote-Mac optional für Always-on-Agenten.

vs. Messages API?

Messages API: Sie implementieren die Tool-Schleife. Agent SDK: Anthropics Schleife + eingebaute Tools — schnelleres abgesichertes v1.

MacLogin KI-Automatisierungsteam

Guides zu Agent SDK, Permissions und ehrlichen Assistenten.

Optional: Cloud-Mac für 24/7-Agenten

Quickstart auf dem Laptop—Miete nur bei Dauerbetrieb nötig.

Preise Hilfe