Berechtigungen konfigurieren

​

Wie Berechtigungen ausgewertet werden

• permissionMode: 'bypassPermissions', das jeden Aufruf automatisch genehmigt, der den Berechtigungsmodus-Schritt erreicht, außer den Aktionen, die kein Modus automatisch genehmigt
• Jeder bare allowedTools Eintrag wie "Read", der dieses ganze Tool automatisch genehmigt, bevor der Callback konsultiert wird, außer den Aktionen, die kein Modus automatisch genehmigt und Lesezugriffen auf Netzwerkpfade

• Hooks: Führen Sie benutzerdefinierten Code aus, um Tool-Anfragen zu erlauben, zu verweigern oder zu ändern. Siehe Ausführung mit Hooks steuern.
• canUseTool Callback: Fordern Sie Benutzer zur Laufzeit zur Genehmigung auf, wenn kein früherer Schritt den Aufruf auflöst. Siehe Genehmigungen und Benutzereingaben verarbeiten.

​

Allow- und Deny-Regeln

const options = {
  allowedTools: ["Read", "Glob", "Grep"],
  permissionMode: "dontAsk"
};

​

Berechtigungsmodi

• Ein permissions.defaultMode aus den Einstellungsdateien der Sitzung, wenn einer zutrifft
• Andernfalls der integrierte Standard, der Auto-Modus sein kann

​

Verfügbare Modi

​

Berechtigungsmodus festlegen

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="Help me refactor this code",
        options=ClaudeAgentOptions(
            permission_mode="default",  # Set the mode here
        ),
    ):
        if hasattr(message, "result"):
            print(message.result)


asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {
  for await (const message of query({
    prompt: "Help me refactor this code",
    options: {
      permissionMode: "default" // Set the mode here
    }
  })) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions


async def main():
    async with ClaudeSDKClient(
        options=ClaudeAgentOptions(
            permission_mode="default",  # Start in default mode
        )
    ) as client:
        await client.query("Help me refactor this code")

        # Change mode dynamically mid-session
        await client.set_permission_mode("acceptEdits")

        # Process messages with the new permission mode
        async for message in client.receive_response():
            if hasattr(message, "result"):
                print(message.result)


asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {
  const q = query({
    prompt: "Help me refactor this code",
    options: {
      permissionMode: "default" // Start in default mode
    }
  });

  // Change mode dynamically mid-session
  await q.setPermissionMode("acceptEdits");

  // Process messages with the new permission mode
  for await (const message of q) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

​

Modusdetails

​

Bearbeitungsmodus akzeptieren (acceptEdits)

• Dateibearbeitungen (Edit-, Write-Tools)
• Dateisystembefehle: mkdir, touch, rm, rmdir, mv, cp, sed

• An einem Pfad außerhalb dieses Bereichs arbeitet
• In einen geschützten Pfad schreibt
• Einen kritischen Pfad mit rm oder rmdir löscht

​

Nicht-Fragen-Modus (dontAsk)

​

Berechtigungen umgehen-Modus (bypassPermissions)

​

Planungsmodus (plan)

​

Auto-Modus (auto)

• Was Sie sehen: eine system-Nachricht mit dem Subtyp status und permissionMode auf "default" gesetzt, die das TypeScript SDK als SDKStatusMessage typisiert. Ab diesem Zeitpunkt erreichen Aufrufe, die eine Genehmigung benötigen und keine Allow-Regel erfüllen, Ihren canUseTool-Callback.
• Zurück zum Auto-Modus: Wechseln Sie zu einem unterstützten Modell und rufen Sie dann set_permission_mode("auto") oder setPermissionMode("auto") auf. Wenn Sie das Modell zurückwechseln, ohne diesen Aufruf auszuführen, bleibt die Sitzung im default-Modus. Solange das nicht unterstützte Modell aktiv ist, schlägt der Aufruf mit Cannot set permission mode to auto: auto mode unavailable for this model fehl.

​

Verwandte Ressourcen

• Genehmigungen und Benutzereingaben verarbeiten: interaktive Genehmigungsaufforderungen und Klärungsfragen
• Hooks-Anleitung: Ausführung von benutzerdefiniertem Code an wichtigen Punkten im Agent-Lebenszyklus
• Berechtigungsregeln: deklarative Allow/Deny-Regeln in settings.json