Loading...
    • Panduan Pengembang
    • Referensi API
    • MCP
    • Sumber daya
    • Catatan rilis
    Search...
    ⌘K
    Langkah pertama
    Pengenalan ClaudeMulai cepat
    Model & harga
    Ikhtisar modelMemilih modelYang baru di Claude 4.6Panduan migrasiPenghentian modelHarga
    Bangun dengan Claude
    Ikhtisar fiturMenggunakan Messages APIMenangani alasan berhentiPraktik terbaik prompting
    Manajemen konteks
    Jendela konteksKompresiPengeditan konteks
    Kemampuan
    Caching promptPemikiran diperpanjangPemikiran adaptifUpayaStreaming pesanPemrosesan batchKutipanDukungan multibahasaPenghitungan tokenEmbeddingsVisiDukungan PDFFiles APIHasil pencarianOutput terstruktur
    Alat
    IkhtisarCara mengimplementasikan penggunaan alatStreaming alat berbutir halusAlat BashAlat eksekusi kodePemanggilan alat terprogramAlat penggunaan komputerAlat editor teksAlat pengambilan webAlat pencarian webAlat memoriAlat pencarian alat
    Keterampilan Agen
    IkhtisarMulai cepatPraktik terbaikKeterampilan untuk perusahaanMenggunakan Keterampilan dengan API
    Agent SDK
    IkhtisarMulai cepatTypeScript SDKTypeScript V2 (pratinjau)Python SDKPanduan migrasi
    Input streamingStreaming respons secara real-timeMenangani alasan berhentiMenangani izinPersetujuan pengguna dan inputKontrol eksekusi dengan hookManajemen sesiCheckpointing fileOutput terstruktur di SDKHosting Agent SDKPenyebaran agen AI dengan amanMemodifikasi prompt sistemMCP di SDKAlat kustomSubagen di SDKPerintah garis miring di SDKKeterampilan agen di SDKPelacakan biaya dan penggunaanDaftar tugasPlugin di SDK
    MCP di API
    Konektor MCPServer MCP jarak jauh
    Claude di platform pihak ketiga
    Amazon BedrockMicrosoft FoundryVertex AI
    Rekayasa prompt
    IkhtisarGenerator promptGunakan template promptPenyempurna promptJadilah jelas dan langsungGunakan contoh (prompting multishot)Biarkan Claude berpikir (CoT)Gunakan tag XMLBerikan Claude peran (prompt sistem)Rantai prompt kompleksTips konteks panjangTips pemikiran diperpanjang
    Uji & evaluasi
    Tentukan kriteria kesuksesanKembangkan kasus ujiMenggunakan alat evaluasiMengurangi latensi
    Perkuat penjaga
    Kurangi halusinasiTingkatkan konsistensi outputMitigasi jailbreakStreaming penolakanKurangi kebocoran promptJaga Claude tetap dalam karakter
    Administrasi dan pemantauan
    Ikhtisar Admin APIResidensi dataRuang kerjaAPI penggunaan dan biayaClaude Code Analytics APIRetensi data nol
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Panduan

    Konfigurasi izin

    Kontrol bagaimana agen Anda menggunakan alat dengan mode izin, hook, dan aturan allow/deny deklaratif.

    Claude Agent SDK menyediakan kontrol izin untuk mengelola bagaimana Claude menggunakan alat. Gunakan mode izin dan aturan untuk menentukan apa yang diizinkan secara otomatis, dan callback canUseTool untuk menangani segalanya di runtime.

    Halaman ini mencakup mode izin dan aturan. Untuk membangun alur persetujuan interaktif di mana pengguna menyetujui atau menolak permintaan alat di runtime, lihat Tangani persetujuan dan input pengguna.

    Bagaimana izin dievaluasi

    Ketika Claude meminta alat, SDK memeriksa izin dalam urutan ini:

    1. 1

      Hook

      Jalankan hook terlebih dahulu, yang dapat mengizinkan, menolak, atau melanjutkan ke langkah berikutnya

    2. 2

      Aturan izin

      Periksa aturan yang ditentukan dalam settings.json dalam urutan ini: aturan deny terlebih dahulu (blokir terlepas dari aturan lain), kemudian aturan allow (izinkan jika cocok), kemudian aturan ask (minta persetujuan). Aturan deklaratif ini memungkinkan Anda untuk pra-menyetujui, memblokir, atau memerlukan persetujuan untuk alat tertentu tanpa menulis kode.

    3. 3

      Mode izin

      Terapkan mode izin aktif (bypassPermissions, acceptEdits, dontAsk, dll.)

    4. 4

      Callback canUseTool

      Jika tidak diselesaikan oleh aturan atau mode, panggil callback canUseTool Anda untuk keputusan

    Permission evaluation flow diagram

    Halaman ini berfokus pada mode izin (langkah 3), konfigurasi statis yang mengontrol perilaku default. Untuk langkah-langkah lainnya:

    • Hook: jalankan kode khusus untuk mengizinkan, menolak, atau memodifikasi permintaan alat. Lihat Kontrol eksekusi dengan hook.
    • Aturan izin: konfigurasi aturan allow/deny deklaratif dalam settings.json. Lihat Pengaturan izin.
    • Callback canUseTool: minta persetujuan pengguna di runtime. Lihat Tangani persetujuan dan input pengguna.

    Mode izin

    Mode izin menyediakan kontrol global atas bagaimana Claude menggunakan alat. Anda dapat mengatur mode izin saat memanggil query() atau mengubahnya secara dinamis selama sesi streaming.

    Mode yang tersedia

    SDK mendukung mode izin ini:

    ModeDeskripsiPerilaku alat
    defaultPerilaku izin standarTidak ada persetujuan otomatis; alat yang tidak cocok memicu callback canUseTool Anda
    acceptEditsTerima otomatis edit fileEdit file dan operasi sistem file (mkdir, rm, mv, dll.) disetujui secara otomatis
    bypassPermissionsLewati semua pemeriksaan izinSemua alat berjalan tanpa prompt izin (gunakan dengan hati-hati)
    planMode perencanaanTidak ada eksekusi alat; Claude merencanakan tanpa membuat perubahan

    Warisan subagen: Saat menggunakan bypassPermissions, semua subagen mewarisi mode ini dan tidak dapat ditimpa. Subagen mungkin memiliki prompt sistem yang berbeda dan perilaku yang kurang terbatas daripada agen utama Anda. Mengaktifkan bypassPermissions memberikan mereka akses sistem penuh dan otonom tanpa prompt persetujuan apa pun.

    Atur mode izin

    Anda dapat mengatur mode izin sekali saat memulai kueri, atau mengubahnya secara dinamis saat sesi aktif.

    Detail mode

    Mode terima edit (acceptEdits)

    Menyetujui operasi file secara otomatis sehingga Claude dapat mengedit kode tanpa meminta. Alat lain (seperti perintah Bash yang bukan operasi sistem file) masih memerlukan izin normal.

    Operasi yang disetujui otomatis:

    • Edit file (alat Edit, Write)
    • Perintah sistem file: mkdir, touch, rm, mv, cp

    Gunakan saat: Anda mempercayai edit Claude dan menginginkan iterasi lebih cepat, seperti selama prototyping atau saat bekerja di direktori terisolasi.

    Mode lewati izin (bypassPermissions)

    Menyetujui semua penggunaan alat tanpa prompt. Hook masih dijalankan dan dapat memblokir operasi jika diperlukan.

    Gunakan dengan sangat hati-hati. Claude memiliki akses sistem penuh dalam mode ini. Hanya gunakan di lingkungan terkontrol di mana Anda mempercayai semua operasi yang mungkin.

    Mode rencana (plan)

    Mencegah eksekusi alat sepenuhnya. Claude dapat menganalisis kode dan membuat rencana tetapi tidak dapat membuat perubahan. Claude dapat menggunakan AskUserQuestion untuk memperjelas persyaratan sebelum menyelesaikan rencana. Lihat Tangani persetujuan dan input pengguna untuk menangani prompt ini.

    Gunakan saat: Anda ingin Claude mengusulkan perubahan tanpa menjalankannya, seperti selama tinjauan kode atau ketika Anda perlu menyetujui perubahan sebelum dibuat.

    Sumber daya terkait

    Untuk langkah-langkah lain dalam alur evaluasi izin:

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

    Was this page helpful?

    • Bagaimana izin dievaluasi
    • Mode izin
    • Mode yang tersedia
    • Atur mode izin
    • Detail mode
    • Sumber daya terkait