Konfigurasi izin

​

Bagaimana izin dievaluasi

• permissionMode: 'bypassPermissions', yang menyetujui setiap panggilan yang mencapai langkah mode izin terlepas dari tindakan yang tidak ada mode auto-approve
• Setiap entri allowedTools bare seperti "Read", yang menyetujui seluruh tool itu sebelum callback dikonsultasikan, terlepas dari tindakan yang tidak ada mode auto-approve dan pembacaan dari jalur jaringan

• Hooks: jalankan kode khusus untuk mengizinkan, menolak, atau memodifikasi permintaan alat. Lihat Control execution with hooks.
• canUseTool callback: minta persetujuan pengguna saat runtime, ketika tidak ada langkah sebelumnya yang menyelesaikan panggilan. Lihat Handle approvals and user input.

​

Aturan izin dan penolakan

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

​

Mode izin

• permissions.defaultMode dari file pengaturan sesi ketika satu berlaku
• Jika tidak, default bawaan, yang dapat berupa mode auto

​

Mode yang tersedia

​

Atur mode izin

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();

​

Detail mode

​

Mode terima pengeditan (acceptEdits)

• Pengeditan file (tools Edit, Write)
• Perintah sistem file: mkdir, touch, rm, rmdir, mv, cp, sed

• Bekerja pada jalur di luar cakupan itu
• Menulis ke jalur yang dilindungi
• Menghapus jalur kritis dengan rm atau rmdir

​

Mode jangan tanya (dontAsk)

​

Mode lewati izin (bypassPermissions)

​

Mode rencana (plan)

​

Auto mode (auto)

• Yang Anda lihat: pesan system dengan subtype status dan permissionMode diatur ke "default", yang diberi tipe oleh SDK TypeScript sebagai SDKStatusMessage. Sejak saat itu, panggilan yang memerlukan persetujuan dan tidak cocok dengan aturan allow mencapai callback canUseTool Anda.
• Untuk kembali ke auto mode: beralih ke model yang didukung, lalu panggil set_permission_mode("auto") atau setPermissionMode("auto"). Jika Anda mengembalikan model tanpa melakukan panggilan tersebut, sesi tetap dalam mode default. Selama model yang tidak didukung aktif, panggilan tersebut gagal dengan Cannot set permission mode to auto: auto mode unavailable for this model.

​

Sumber daya terkait

• Menangani persetujuan dan input pengguna: prompt persetujuan interaktif dan pertanyaan klarifikasi
• Panduan hooks: jalankan kode khusus pada titik-titik kunci dalam siklus hidup agen
• Aturan izin: aturan allow/deny deklaratif dalam settings.json