​

Izin SDK

​

Gambaran Umum

1. Mode Izin - Pengaturan perilaku izin global yang mempengaruhi semua alat
2. callback canUseTool - Penanganan izin runtime untuk kasus yang tidak dicakup oleh aturan lain
3. Hooks - Kontrol yang detail atas setiap eksekusi alat dengan logika kustom
4. Aturan izin (settings.json) - Aturan allow/deny deklaratif dengan parsing perintah bash terintegrasi

• Mode izin - Mengatur perilaku izin keseluruhan (perencanaan, otomatis menerima edit, melewati pemeriksaan)
• canUseTool - Persetujuan dinamis untuk kasus yang tidak tercakup, meminta izin pengguna
• Hooks - Kontrol programatis atas semua eksekusi alat
• Aturan izin - Kebijakan statis dengan parsing perintah bash yang cerdas

​

Diagram Alur Izin

​

Mode Izin

​

Mode yang Tersedia

​

Mengatur Mode Izin

​

1. Konfigurasi Awal

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

const result = await query({
  prompt: "Bantu saya refactor kode ini",
  options: {
    permissionMode: 'default'  // Mode izin standar
  }
});

​

2. Perubahan Mode Dinamis (Hanya Streaming)

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

// Buat async generator untuk input streaming
async function* streamInput() {
  yield { 
    type: 'user',
    message: { 
      role: 'user', 
      content: "Mari mulai dengan izin default" 
    }
  };
  
  // Nanti dalam percakapan...
  yield {
    type: 'user',
    message: {
      role: 'user',
      content: "Sekarang mari percepat pengembangan"
    }
  };
}

const q = query({
  prompt: streamInput(),
  options: {
    permissionMode: 'default'  // Mulai dalam mode default
  }
});

// Ubah mode secara dinamis
await q.setPermissionMode('acceptEdits');

// Proses pesan
for await (const message of q) {
  console.log(message);
}

​

Perilaku Spesifik Mode

​

Mode Accept Edits (acceptEdits)

• Semua edit file secara otomatis disetujui
• Operasi filesystem (mkdir, touch, rm, dll.) secara otomatis disetujui
• Alat lain masih memerlukan izin normal
• Mempercepat pengembangan ketika Anda mempercayai edit Claude
• Berguna untuk prototyping cepat dan iterasi

• Edit file (alat Edit, Write)
• Perintah filesystem bash (mkdir, touch, rm, mv, cp)
• Pembuatan dan penghapusan file

​

Mode Bypass Permissions (bypassPermissions)

• SEMUA penggunaan alat secara otomatis disetujui
• Tidak ada prompt izin yang muncul
• Hooks masih dieksekusi (masih dapat memblokir operasi)
• Gunakan dengan sangat hati-hati - Claude memiliki akses sistem penuh
• Direkomendasikan hanya untuk lingkungan terkontrol

​

Prioritas Mode dalam Alur Izin

1. Hooks dieksekusi terlebih dahulu - Dapat mengizinkan, menolak, bertanya, atau melanjutkan
2. Aturan tolak diperiksa - Memblokir alat terlepas dari mode
3. Aturan izinkan diperiksa - Mengizinkan alat jika cocok
4. Aturan tanya diperiksa - Meminta izin jika cocok
5. Mode izin dievaluasi:
   • Mode bypassPermissions - Jika aktif, mengizinkan semua alat yang tersisa
   • Mode lain - Menunda ke callback canUseTool
6. Callback canUseTool - Menangani kasus yang tersisa

• Hooks selalu dapat mengontrol penggunaan alat, bahkan dalam mode bypassPermissions
• Aturan tolak eksplisit menimpa semua mode izin
• Aturan tanya dievaluasi sebelum mode izin
• Mode bypassPermissions menimpa callback canUseTool untuk alat yang tidak cocok

​

Praktik Terbaik

1. Gunakan mode default untuk eksekusi terkontrol dengan pemeriksaan izin normal
2. Gunakan mode acceptEdits saat bekerja pada file atau direktori yang terisolasi
3. Hindari bypassPermissions dalam produksi atau pada sistem dengan data sensitif
4. Gabungkan mode dengan hooks untuk kontrol yang detail
5. Beralih mode secara dinamis berdasarkan kemajuan tugas dan kepercayaan

// Mulai dalam mode default untuk eksekusi terkontrol
permissionMode: 'default'

// Beralih ke acceptEdits untuk iterasi cepat
await q.setPermissionMode('acceptEdits')

​

canUseTool

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

async function promptForToolApproval(toolName: string, input: any) {
  console.log("\n🔧 Permintaan Alat:");
  console.log(`   Alat: ${toolName}`);
  
  // Tampilkan parameter alat
  if (input && Object.keys(input).length > 0) {
    console.log("   Parameter:");
    for (const [key, value] of Object.entries(input)) {
      let displayValue = value;
      if (typeof value === 'string' && value.length > 100) {
        displayValue = value.substring(0, 100) + "...";
      } else if (typeof value === 'object') {
        displayValue = JSON.stringify(value, null, 2);
      }
      console.log(`     ${key}: ${displayValue}`);
    }
  }
  
  // Dapatkan persetujuan pengguna (ganti dengan logika UI Anda)
  const approved = await getUserApproval();
  
  if (approved) {
    console.log("   ✅ Disetujui\n");
    return {
      behavior: "allow",
      updatedInput: input
    };
  } else {
    console.log("   ❌ Ditolak\n");
    return {
      behavior: "deny",
      message: "Pengguna menolak izin untuk alat ini"
    };
  }
}

// Gunakan callback izin
const result = await query({
  prompt: "Bantu saya analisis codebase ini",
  options: {
    canUseTool: async (toolName, input) => {
      return promptForToolApproval(toolName, input);
    }
  }
});

​

Sumber Daya Terkait

• Panduan Hooks - Pelajari cara mengimplementasikan hooks untuk kontrol yang detail atas eksekusi alat
• Pengaturan: Aturan Izin - Konfigurasi aturan allow/deny deklaratif dengan parsing perintah bash