Permission Modes Claude Code: Otonomi vs Keamanan

Setiap tindakan yang diambil agen coding AI berada di suatu titik pada garis antara tak berbahaya dan tak bisa dibatalkan. Membaca berkas itu aman; menyuntingnya biasanya tak masalah; menjalankan perintah shell yang menghapus data atau memanggil jaringan bukanlah sesuatu yang Anda ingin terjadi tanpa persetujuan Anda. Permission modes adalah cara Claude Code membiarkan Anda menetapkan di mana garis itu jatuh.

Alih-alih satu kebijakan tetap, Claude Code memberi Anda sekumpulan kecil mode yang menukar prompt persetujuan dengan otonomi dalam takaran berbeda. Panduan ini menjelaskan tiap mode, cara berpindah di antaranya, dan cara mencocokkan mode dengan tugas agar Anda tidak sekadar mengecap setiap suntingan maupun menyerahkan cek kosong kepada agen.

Mode-mode izin

Claude Code mengelompokkan perilakunya ke dalam segelintir mode, masing-masing mendefinisikan apa yang terjadi otomatis dan apa yang berhenti untuk persetujuan Anda. Mengetahui empat mode yang benar-benar akan Anda pakai mencakup hampir tiap situasi.

Dari yang paling berhati-hati sampai paling permisif, mereka adalah:

• Plan mode bersifat read-only: agen bisa menjelajah dan mengusulkan pendekatan tetapi tidak bisa menyunting berkas atau menjalankan perintah, yang menjadikannya ideal untuk berpikir sebelum menyentuh apa pun.
• Default mode membiarkannya bekerja tetapi meminta persetujuan Anda sebelum tindakan berisiko seperti menyunting berkas atau menjalankan perintah shell, menjaga manusia dalam loop pada apa pun yang berkonsekuensi.
• Mode acceptEdits menyetujui suntingan berkas secara otomatis sehingga Anda tidak mengeklik tiap perubahan, sambil tetap menggerbang operasi yang lebih berbahaya.
• Mode bypassPermissions melewati prompt persetujuan sama sekali, membiarkan agen berjalan tanpa pengawasan, yang kuat dan sekaligus cara termudah menimbulkan kerusakan nyata.

Cara berpindah mode

Anda bisa mengubah mode secara langsung di dalam sesi atau menyiapkannya di awal. Secara interaktif, menekan Shift+Tab memutari mode-mode itu, sehingga Anda bisa masuk ke plan mode untuk merancang lalu naik ke mode kerja begitu Anda menyepakati pendekatannya. Untuk run headless dan terskrip, Anda memberikan mode sebagai sebuah flag.

Anda juga bisa menyatakan kebijakan tetap di settings alih-alih memilih setiap kali. Sebuah daftar allow-and-deny di project settings Anda menyebutkan persis tool dan perintah mana yang diizinkan, sehingga agen berperilaku konsisten di seluruh tim:

{
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Bash(npm run test:*)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "WebFetch"
    ]
  }
}

Cocokkan mode dengan tugas

Mode yang tepat adalah fungsi dari seberapa bisa dibatalkan pekerjaannya dan seberapa Anda memercayai lingkungan tempatnya berjalan. Beberapa default mencakup sebagian besar hari.

• Menjelajahi basis kode yang asing atau merencanakan sebuah perubahan: plan mode, sehingga tidak ada yang disunting selagi Anda berpikir.
• Kerja fitur normal di terminal Anda: default mode, menyetujui segelintir langkah berisiko saat muncul.
• Sebuah refactor panjang yang tercakup baik dan Anda awasi aktif: acceptEdits, untuk melewati banjir prompt suntingan tanpa kehilangan persetujuan perintah.
• Otomasi sepenuhnya tanpa pengawasan: bypassPermissions hanya di dalam sandbox atau lingkungan sekali pakai, jangan pernah terhadap mesin dengan akses produksi.

Trade-off otonomi versus keamanan

Tiap langkah menuju otonomi lebih besar menghapus satu titik pemeriksaan di mana manusia akan menangkap sebuah kesalahan. Itulah seluruh daya tariknya sekaligus seluruh risikonya: lebih sedikit prompt berarti kerja lebih cepat dan gesekan lebih kecil, tetapi juga lebih sedikit kesempatan menghentikan tindakan buruk sebelum ia mendarat.

Bahayanya tidak tersebar merata di seluruh tindakan. Menyunting berkas mudah direview dan mudah dibatalkan; perintah shell atau panggilan jaringan bisa keduanya tidak. Itulah mengapa mode-mode tetap menggerbang perintah bahkan ketika berhenti menggerbang suntingan, dan mengapa lompatan ke melewati semua persetujuan adalah perubahan risiko yang sesungguhnya alih-alih sekadar lebih nyaman.

Bangun default yang aman

Permission modes bekerja paling baik sebagai bagian dari penyiapan tetap alih-alih keputusan yang Anda improvisasi di bawah tekanan tiap sesi.

• Commit daftar allow-and-deny ke proyek Anda sehingga tiap rekan tim dan run CI mewarisi batasan yang sama secara default.
• Default ke mode paling ketat yang masih membuat tugas bergerak, dan naikkan otonomi hanya ketika pekerjaan jelas menuntutnya.
• Pasangkan mode permisif apa pun dengan sandbox, sehingga keamanan datang dari lingkungan dan bukan hanya dari perhatian Anda.

Permission modes adalah tuas keamanan paling penting di Claude Code. Pelajari keempatnya, putari dengan Shift+Tab, kodekan aturan tetap dalam daftar allow-and-deny, dan jaga mode paling permisif terkunci di dalam sandbox. Tujuannya bukan otonomi maksimum atau kehati-hatian maksimum melainkan otonomi paling sedikit yang benar-benar dibutuhkan tiap tugas, di situlah kecepatan dan keamanan berhenti saling bertentangan.