Claude Code SDK + AnyCap: Wenn du mehr als nur Code brauchst

Zuletzt aktualisiert: 4. Juni 2026

Das Claude Code SDK ist ideal, wenn die Aufgabe noch überwiegend aus Code besteht: CI-Prüfungen, Code-Reviews, strukturierte Ausgaben und MCP-bewusste Automatisierung. Sobald ein Workflow jedoch Suche, Medien, Publishing oder andere Nicht-Code-Funktionen benötigt, reicht das Claude Code SDK allein nicht mehr aus.

Hier kommt AnyCap ins Spiel. AnyCap ist eine Agent-CLI, die Coding-Agents über die reine Codeausführung hinaus erweitert, sodass derselbe Workflow von der Codeanalyse über Recherche und Asset-Erstellung bis hin zur Auslieferung wechseln kann.

Kurzfassung

• Verwende Claude Code SDK für codezentrierte Automatisierung
• Füge AnyCap hinzu, wenn der Workflow Suche, Medien, Publishing oder Auslieferung benötigt
• Betrachte das Claude Code SDK als die Coding-Laufzeit
• Betrachte AnyCap als die Fähigkeitsschicht jenseits von Code

Was ist das Claude Code SDK?

Das Claude Code SDK ist eine programmgesteuerte Schnittstelle, mit der du:

• Claude Code nicht interaktiv aus Skripten und Pipelines ausführen kannst
• Steuern kannst, welche Dateien, Verzeichnisse und Tools im Kontext sind
• Strukturierte Ausgaben für die Weiterverarbeitung parsen kannst
• Claude Code mit anderen Tools in automatisierten Workflows verkettest
• Eigene UIs auf Basis der Schlussfolgerungsfähigkeit von Claude Code baust

Als Node.js-Paket verfügbar:

npm install @anthropic-ai/claude-code

Oder per CLI im nicht interaktiven Modus aufrufen:

claude -p "Dein Prompt hier" --output-format json

Zentrale SDK-Konzepte

Nicht interaktiver Modus

Der einfachste Anwendungsfall für das SDK: Claude Code mit einem Prompt ausführen, Ausgabe erhalten, fertig.

# CLI nicht interaktiv
claude -p "Prüfe src/auth.ts auf Sicherheitslücken" \
  --output-format json \
  --max-turns 5

// SDK
const { query } = require('@anthropic-ai/claude-code');

const result = await query({
  prompt: "Prüfe src/auth.ts auf Sicherheitslücken",
  options: {
    maxTurns: 5,
    outputFormat: 'json'
  }
});

Tool-Konfiguration

Steuere, auf welche Tools Claude Code in deinem SDK-Aufruf zugreifen darf:

const result = await query({
  prompt: "Erstelle eine Test-Suite für src/utils.ts",
  options: {
    allowedTools: ['Read', 'Write', 'Bash'],
    // Deaktiviere Tools, die du nicht brauchst:
    // disallowedTools: ['WebSearch', 'mcp__custom_tool']
  }
});

Benutzerdefinierte System-Prompts

Überschreibe den Standard-System-Prompt von Claude Code für spezialisiertes Verhalten:

const result = await query({
  prompt: "Refaktoriere dieses Modul",
  options: {
    systemPrompt: `Du bist ein TypeScript-Experte mit Fokus auf funktionale Programmiermuster.
    Bevorzuge immer unveränderliche Datenstrukturen. Verwende Result-Typen für Fehlerbehandlung.
    Nutze niemals any- oder unknown-Typen.`,
  }
});

Praktische SDK-Muster

1. Automatisiertes Code-Review in CI

// .github/workflows/code-review.js
const { query } = require('@anthropic-ai/claude-code');
const { execSync } = require('child_process');

const diff = execSync('git diff main...HEAD').toString();

const review = await query({
  prompt: `Prüfe diesen PR-Diff auf: Sicherheitsprobleme, Performance-Probleme und fehlende Tests.
  Gib die Ausgabe als JSON mit den Schlüsseln aus: security[], performance[], testing[].
  
  Diff:
  ${diff}`,
  options: {
    outputFormat: 'json',
    allowedTools: ['Read'],  // Nur lesen in CI
    maxTurns: 3
  }
});

console.log(JSON.parse(review.result));

2. Automatisierte Dokumentationsgenerierung

const fs = require('fs');
const { query } = require('@anthropic-ai/claude-code');

async function generateDocs(srcPath) {
  const result = await query({
    prompt: `Erstelle eine umfassende JSDoc-Dokumentation für alle exportierten Funktionen in ${srcPath}.
    Ergänze Parameterbeschreibungen, Rückgabetypen und Anwendungsbeispiele.
    Schreibe die aktualisierte Datei mit eingefügter Dokumentation zurück.`,
    options: {
      allowedTools: ['Read', 'Write'],
      cwd: process.cwd()
    }
  });
  return result;
}

3. Multi-Agent-Workflow mit externen Fähigkeiten

Hier wird AnyCap besonders nützlich. Claude Code übernimmt die Code-Analyse, während AnyCap die Aufgaben übernimmt, die außerhalb der Coding-Laufzeit liegen.

const { query } = require('@anthropic-ai/claude-code');
const { execSync } = require('child_process');

async function buildAndPublishDocs(repoPath) {
  // Schritt 1: Claude Code erstellt die Dokumentation
  const docsResult = await query({
    prompt: "Erstelle eine umfassende README für dieses Projekt mit Einrichtungsanleitung, API-Referenz und Beispielen",
    options: {
      cwd: repoPath,
      allowedTools: ['Read', 'Write', 'Bash']
    }
  });

  // Schritt 2: AnyCap erzeugt ein Hero-Diagramm
  execSync(`anycap image generate \
    --prompt "Technisches Architekturdiagramm für ein Entwickler-Tool, sauberer minimalistischer Stil" \
    --model nano-banana-2 \
    -o ${repoPath}/docs/architecture.png`);

  // Schritt 3: AnyCap veröffentlicht als Webseite
  const pageResult = execSync(`anycap page deploy ${repoPath}/docs/`).toString();
  
  return { docs: docsResult, page: JSON.parse(pageResult) };
}

SDK-Authentifizierung

Das SDK verwendet dieselbe Authentifizierung wie Claude Code. Lege deinen API-Schlüssel fest:

export ANTHROPIC_API_KEY=your_key_here

Oder nutze für Team-Umgebungen eine umgebungsspezifische Konfiguration:

const { query } = require('@anthropic-ai/claude-code');

// Das SDK liest ANTHROPIC_API_KEY automatisch aus
// Oder explizit setzen:
process.env.ANTHROPIC_API_KEY = await getSecretFromVault('anthropic-api-key');

Ausgabeformate

Das SDK unterstützt drei Ausgabeformate:

// JSON-Ausgabe enthält Metadaten
{
  "result": "Die Funktion weist möglicherweise eine SQL-Injection-Schwachstelle auf...",
  "is_error": false,
  "session_id": "sess_xxxx",
  "cost_usd": 0.0043,
  "num_turns": 2
}

Rate Limits und Kostenmanagement in SDK-Workflows

SDK-basierte Automatisierung kann schneller Tokens verbrauchen als interaktive Nutzung. Eingebaute Schutzmechanismen:

const result = await query({
  prompt: "...",
  options: {
    maxTurns: 5,        // Anzahl der Denkiterationen begrenzen
    timeoutMs: 30000,   // Timeout für lang laufende Aufgaben
  }
});

// Kosten in der Produktion immer prüfen
if (result.cost_usd > 0.10) {
  logger.warn(`Sitzung mit hohen Kosten: $${result.cost_usd}`);
}

Für Aufgaben mit hohem Capability-Bedarf (Bildgenerierung, Videoerstellung, Websuche) solltest du auf AnyCap auslagern, statt Claude Code sie im Kontext erledigen zu lassen. So bleiben die SDK-Kosten kalkulierbar und du vermeidest, dass bei nicht denkintensiven Aufgaben die Claude-Limits erreicht werden.

Erste Schritte

# SDK installieren
npm install @anthropic-ai/claude-code

# AnyCap für zusätzliche Fähigkeiten installieren
curl -fsSL https://anycap.ai/install.sh | sh

# AnyCap-Skill zu Claude Code hinzufügen
npx -y skills add anycap-ai/anycap -y

→ AnyCap für Claude Code → Anleitung: Tools zu Claude Code hinzufügen