20 Arsitektur berbasis izin20 Arsitektur berbasis izin

21</h3>21</h3>

22 22 

23Dalam mode Manual, Claude Code dimulai dengan izin baca-saja. Ketika Claude Code perlu mengedit file, menjalankan tes, atau mengeksekusi perintah, Claude Code meminta Anda terlebih dahulu, dan Anda memilih apakah akan menyetujui tindakan sekali atau mengizinkannya dari saat itu.23Mode izin sebuah sesi menentukan tindakan mana yang dapat dilakukan Claude tanpa meminta persetujuan Anda terlebih dahulu. Auto mode adalah mode izin awal bawaan untuk sesi terminal interaktif dan VS Code. [Mode mana yang digunakan saat sesi dimulai](/docs/id/permission-modes#which-mode-a-session-starts-in) membahas versi sebelumnya, surface lainnya, dan pengaturan yang mengubah mode izin awal.

24 24 

25Dalam mode Manual, Claude Code juga meminta sebelum menjalankan perintah Bash yang dapat memodifikasi sistem Anda. Claude Code menjalankan serangkaian [perintah baca-saja](/docs/id/permissions#read-only-commands) bawaan seperti `ls`, `cat`, dan `git status` tanpa meminta. Anda dan organisasi Anda mengonfigurasi izin ini secara langsung.25* **Auto mode**: Model pengklasifikasi terpisah meninjau tindakan alih-alih Anda dan memblokir tindakan yang dianggapnya tidak aman. [Bagaimana pengklasifikasi mengevaluasi tindakan](/docs/id/permission-modes#how-the-classifier-evaluates-actions) mencantumkan tindakan mana yang Claude Code setujui sepenuhnya, tindakan mana yang dikirimnya ke pengklasifikasi, dan tindakan mana yang masih diminta Claude Code kepada Anda. Aturan permintaan dan penolakan eksplisit Anda masih berlaku, dan organisasi Anda dapat [mematikan auto mode](/docs/id/permission-modes#eliminate-prompts-with-auto-mode)

26* **Mode Manual**: Claude Code dimulai dengan izin read-only. Ketika Claude Code perlu mengedit file, menjalankan tes, atau mengeksekusi perintah, Claude Code meminta Anda terlebih dahulu, dan Anda memilih apakah akan menyetujui tindakan sekali atau mengizinkannya dari saat itu. Claude Code menjalankan serangkaian [perintah read-only](/docs/id/permissions#read-only-commands) bawaan seperti `ls`, `cat`, dan `git status` tanpa meminta

26 27 

27Dalam [mode auto](/docs/id/permission-modes#eliminate-prompts-with-auto-mode), model pengklasifikasi terpisah meninjau tindakan alih-alih Anda dan memblokir tindakan yang dianggapnya tidak aman. [Bagaimana pengklasifikasi mengevaluasi tindakan](/docs/id/permission-modes#how-the-classifier-evaluates-actions) mencantumkan tindakan mana yang Claude Code setujui sepenuhnya, tindakan mana yang dikirimnya ke pengklasifikasi, dan tindakan mana yang masih diminta Claude Code kepada Anda. Aturan permintaan dan penolakan eksplisit Anda masih berlaku, dan organisasi Anda dapat [mematikan mode auto](/docs/id/permission-modes#eliminate-prompts-with-auto-mode).28Anda dan organisasi Anda mengonfigurasi izin ini secara langsung. Untuk konfigurasi izin terperinci, lihat [Permissions](/docs/id/permissions).

28 

29Mode izin mana yang dimulai sesi tergantung pada paket Anda, permukaan tempat Anda memulainya, dan pengaturan Anda serta organisasi Anda; lihat [Permission modes](/docs/id/permission-modes#which-mode-a-session-starts-in).

30 

31Untuk konfigurasi izin terperinci, lihat [Permissions](/docs/id/permissions).

32 29 

33<h3 id="built-in-protections">30<h3 id="built-in-protections">

34 Perlindungan bawaan31 Perlindungan bawaan

37Untuk mengurangi risiko dalam sistem agentic:34Untuk mengurangi risiko dalam sistem agentic:

38 35 

39* **Alat bash bersandbox**: [Sandbox](/docs/id/sandboxing) perintah bash dengan isolasi filesystem dan jaringan, mengurangi permintaan izin sambil mempertahankan keamanan. Konfigurasi dengan `/sandbox` untuk menentukan batas tempat Claude Code dapat bekerja secara otonom36* **Alat bash bersandbox**: [Sandbox](/docs/id/sandboxing) perintah bash dengan isolasi filesystem dan jaringan, mengurangi permintaan izin sambil mempertahankan keamanan. Konfigurasi dengan `/sandbox` untuk menentukan batas tempat Claude Code dapat bekerja secara otonom

40* **Pembatasan direktori kerja**: Dalam mode Manual, Claude Code hanya dapat menulis ke folder tempat dimulai dan subfolder-nya, dan tidak dapat memodifikasi file di direktori induk tanpa izin eksplisit. Dalam mode Manual, Claude Code juga meminta Anda sebelum membaca jalur di luar batas ini dengan alat Read, Grep, dan Glob. Perluas batas dengan [direktori tambahan](/docs/id/permissions#working-directories) untuk melewati permintaan, atau batasi akses baca yang lebih luas tersedia untuk perintah Bash baca-saja dengan [aturan sandbox `denyRead`](/docs/id/sandboxing#filesystem-isolation), yang hanya berlaku ketika sandboxing diaktifkan37* **Batas direktori kerja**: Dalam mode Manual, Claude Code meminta persetujuan Anda sebelum tool file-nya membaca atau menulis di luar folder tempat ia dimulai dan subfolder-nya. Batas ini berupa permintaan izin, sehingga perintah Bash yang Anda setujui tetap dapat menulis di mana saja yang dapat diakses oleh akun pengguna Anda

38 * Untuk membaca sebuah folder tanpa permintaan izin, tambahkan folder tersebut sebagai [direktori tambahan](/docs/id/permissions#working-directories)

39 * Untuk membatasi perintah Bash di tingkat sistem operasi, aktifkan [sandboxing](/docs/id/sandboxing#filesystem-isolation)

41* **Mitigasi kelelahan permintaan**: Dukungan untuk allowlisting perintah aman yang sering digunakan per-pengguna, per-codebase, atau per-organisasi40* **Mitigasi kelelahan permintaan**: Dukungan untuk allowlisting perintah aman yang sering digunakan per-pengguna, per-codebase, atau per-organisasi

42* **Mode Accept Edits**: Persetujuan otomatis untuk edit file dan serangkaian perintah Bash filesystem tetap seperti `mkdir`, `touch`, `rm`, `mv`, `cp`, dan `sed` untuk jalur di direktori kerja. Perintah Bash lainnya dan jalur di luar cakupan masih meminta persetujuan41* **Mode Accept Edits**: Persetujuan otomatis untuk edit file dan serangkaian perintah Bash filesystem tetap seperti `mkdir`, `touch`, `rm`, `mv`, `cp`, dan `sed` untuk jalur di direktori kerja. Perintah Bash lainnya dan jalur di luar cakupan masih meminta persetujuan

43 42 

45 Tanggung jawab pengguna44 Tanggung jawab pengguna

46</h3>45</h3>

47 46 

48Claude Code hanya memiliki izin yang Anda berikan. Anda bertanggung jawab untuk meninjau kode dan perintah yang diusulkan untuk keamanan sebelum persetujuan.47Anda bertanggung jawab untuk meninjau kode dan perintah yang diusulkan untuk keamanan sebelum persetujuan.

49 48 

50<h2 id="protect-against-prompt-injection">49<h2 id="protect-against-prompt-injection">

51 Lindungi dari prompt injection50 Lindungi dari prompt injection

58</h3>57</h3>

59 58 

60* **Sistem izin**: Dalam Manual mode, operasi sensitif memerlukan persetujuan eksplisit59* **Sistem izin**: Dalam Manual mode, operasi sensitif memerlukan persetujuan eksplisit

61* **Analisis yang menyadari konteks**: Mendeteksi instruksi yang berpotensi berbahaya dengan menganalisis permintaan lengkap

62* **Sanitasi input**: Mencegah command injection dengan memproses input pengguna

63* **Persetujuan perintah jaringan**: Perintah yang mengambil konten dari web seperti `curl` dan `wget` tidak disetujui secara otomatis secara default. Dalam Manual mode mereka meminta seperti perintah Bash non-read-only lainnya, sehingga Anda masih dapat menyetujui sekali atau menambahkan aturan izin eksplisit seperti `Bash(curl *)`. Untuk menghentikan Claude dari menjalankannya, tambahkan ke [`permissions.deny`](/docs/id/permissions#tool-specific-permission-rules). Aturan deny cocok dengan perintah [seperti yang ditulis](/docs/id/permissions#bash-rule-limits); untuk penegakan jaringan yang tidak bergantung pada teks perintah, lihat [isolasi jaringan sandbox](/docs/id/sandboxing#network-isolation)60* **Persetujuan perintah jaringan**: Perintah yang mengambil konten dari web seperti `curl` dan `wget` tidak disetujui secara otomatis secara default. Dalam Manual mode mereka meminta seperti perintah Bash non-read-only lainnya, sehingga Anda masih dapat menyetujui sekali atau menambahkan aturan izin eksplisit seperti `Bash(curl *)`. Untuk menghentikan Claude dari menjalankannya, tambahkan ke [`permissions.deny`](/docs/id/permissions#tool-specific-permission-rules). Aturan deny cocok dengan perintah [seperti yang ditulis](/docs/id/permissions#bash-rule-limits); untuk penegakan jaringan yang tidak bergantung pada teks perintah, lihat [isolasi jaringan sandbox](/docs/id/sandboxing#network-isolation)

64 61 

65<h3 id="privacy-safeguards">62<h3 id="privacy-safeguards">

79</h3>76</h3>

80 77 

81* **Persetujuan permintaan jaringan**: Dalam Manual mode, sebagian besar alat yang membuat permintaan jaringan memerlukan persetujuan pengguna secara default78* **Persetujuan permintaan jaringan**: Dalam Manual mode, sebagian besar alat yang membuat permintaan jaringan memerlukan persetujuan pengguna secara default

82* **Jendela konteks terisolasi**: Web fetch menggunakan jendela konteks terpisah untuk menghindari injeksi prompt yang berpotensi berbahaya79* **Ringkasan halaman web**: Untuk sebagian besar pengambilan, WebFetch menjalankan panggilan model terpisah atas halaman tersebut, dan Claude menerima jawaban dari panggilan itu alih-alih halaman mentahnya. Lihat [perilaku tool WebFetch](/docs/id/tools-reference#webfetch-tool-behavior)

83* **Verifikasi kepercayaan**: Jalankan codebase pertama kali dan server MCP baru memerlukan verifikasi kepercayaan80* **Verifikasi kepercayaan**: Dalam sesi interaktif, Claude Code menampilkan dialog kepercayaan workspace saat Anda memulainya di folder yang belum Anda percayai. Server dalam `.mcp.json` milik proyek memiliki permintaan persetujuannya sendiri, dan [Cakupan proyek](/docs/id/mcp#project-scope) mencantumkan sesi yang melewatinya

84 * Catatan: Verifikasi kepercayaan dinonaktifkan saat menjalankan secara non-interaktif dengan flag `-p`81 * Catatan: Sesi `-p` tidak menampilkan kedua permintaan tersebut. [Apa yang berjalan sebelum Anda memercayai folder](/docs/id/permissions#what-runs-before-you-trust-a-folder) mencantumkan apa yang dapat dijalankan oleh file repositori di sana

85 * Catatan: Ketika Anda memulai Claude Code langsung di direktori home Anda, penerimaan kepercayaan disimpan untuk sesi saat ini saja dan tidak ditulis ke disk, jadi prompt muncul kembali pada setiap peluncuran. Tidak ada pengaturan untuk mempertahankannya. Mulai Claude Code dari subdirektori proyek sebagai gantinya, di mana penerimaan kepercayaan disimpan per direktori82 * Catatan: Ketika Anda memulai Claude Code langsung di direktori home Anda, penerimaan kepercayaan disimpan untuk sesi saat ini saja dan tidak ditulis ke disk, jadi prompt muncul kembali pada setiap peluncuran. Tidak ada pengaturan untuk mempertahankannya. Mulai Claude Code dari subdirektori proyek sebagai gantinya, di mana penerimaan kepercayaan disimpan per direktori

86* **Deteksi command injection**: Dalam Manual mode, perintah bash yang mencurigakan memerlukan persetujuan manual bahkan jika sebelumnya allowlisted83* **Deteksi command injection**: Dalam Manual mode, Claude Code meminta persetujuan sebelum menjalankan perintah Bash yang tidak dapat dianalisisnya sepenuhnya. Aturan izin untuk sebagian perintah, seperti `Bash(git *)`, tidak melewati permintaan tersebut. [Perintah yang di-sandbox](/docs/id/permissions#how-permissions-interact-with-sandboxing) dapat berjalan tanpanya

87* **Pencocokan fail-closed**: Dalam Manual mode, perintah yang tidak cocok memerlukan persetujuan secara default84* **Pencocokan fail-closed**: Dalam Manual mode, perintah yang tidak cocok memerlukan persetujuan secara default

88* **Deskripsi bahasa alami**: Perintah bash kompleks menyertakan penjelasan untuk pemahaman pengguna85* **Penyimpanan kredensial aman**: Kunci API dan token disimpan di macOS Keychain jika tersedia. Di Linux, keduanya disimpan dalam file dengan mode `0600`, dan di Windows dalam file yang mewarisi kontrol akses direktori profil pengguna Anda. Lihat [Credential Management](/docs/id/authentication#credential-management)

89* **Penyimpanan kredensial aman**: Kunci API dan token disimpan di macOS Keychain jika tersedia, dan dilindungi oleh izin file di Windows dan Linux. Lihat [Credential Management](/docs/id/authentication#credential-management)

90 86 

91<Warning>87<Warning>

92 **Risiko keamanan Windows WebDAV**: Saat menjalankan Claude Code di Windows, kami merekomendasikan untuk tidak mengaktifkan WebDAV atau mengizinkan Claude Code mengakses path seperti `\\*` yang mungkin berisi subdirektori WebDAV. [WebDAV telah dihentikan oleh Microsoft](https://learn.microsoft.com/en-us/windows/whats-new/deprecated-features#:~:text=The%20Webclient%20\(WebDAV\)%20service%20is%20deprecated) karena risiko keamanan. Mengaktifkan WebDAV dapat memungkinkan Claude Code memicu permintaan jaringan ke host jarak jauh, melewati sistem izin.88 **Risiko keamanan Windows WebDAV**: Saat menjalankan Claude Code di Windows, kami merekomendasikan untuk tidak mengaktifkan WebDAV atau mengizinkan Claude Code mengakses path seperti `\\*` yang mungkin berisi subdirektori WebDAV. [WebDAV telah dihentikan oleh Microsoft](https://learn.microsoft.com/en-us/windows/whats-new/deprecated-features#:~:text=The%20Webclient%20\(WebDAV\)%20service%20is%20deprecated) karena risiko keamanan. Mengaktifkan WebDAV dapat memungkinkan Claude Code memicu permintaan jaringan ke host jarak jauh, melewati sistem izin.

110 Keamanan MCP106 Keamanan MCP

111</h2>107</h2>

112 108 

113Claude Code memungkinkan pengguna untuk mengonfigurasi server Model Context Protocol (MCP). Daftar server MCP yang diizinkan dikonfigurasi dalam kode sumber Anda, sebagai bagian dari pengaturan Claude Code yang diperiksa insinyur ke dalam kontrol sumber.109Anda dapat menghubungkan Claude Code ke server Model Context Protocol (MCP). Server dengan cakupan proyek didefinisikan dalam `.mcp.json`, yang dapat Anda masukkan ke dalam kontrol sumber. Server pada [cakupan lain](/docs/id/mcp#mcp-installation-scopes) dan [konektor claude.ai](/docs/id/mcp#how-connectors-reach-claude-code) dikonfigurasi di luar repositori, dan plugin juga dapat menambahkan server, sehingga meninjau `.mcp.json` tidak menampilkan setiap server yang dapat dimuat oleh suatu sesi. Untuk membatasi server mana yang berjalan di organisasi Anda, lihat [Konfigurasi MCP terkelola](/docs/id/managed-mcp).

114 110 

115Kami mendorong untuk menulis server MCP Anda sendiri atau menggunakan server MCP dari penyedia yang Anda percayai. Anda dapat mengonfigurasi izin Claude Code untuk server MCP. Anthropic meninjau konektor terhadap [kriteria pendaftarannya](https://claude.com/docs/connectors/building/review-criteria) sebelum menambahkannya ke [Direktori Anthropic](https://claude.ai/directory), tetapi tidak melakukan audit keamanan atau mengelola server MCP apa pun.111Kami mendorong untuk menulis server MCP Anda sendiri atau menggunakan server MCP dari penyedia yang Anda percayai. Anda dapat mengonfigurasi izin Claude Code untuk server MCP. Anthropic meninjau konektor terhadap [kriteria pendaftarannya](https://claude.com/docs/connectors/building/review-criteria) sebelum menambahkannya ke [Direktori Anthropic](https://claude.ai/directory), tetapi tidak melakukan audit keamanan atau mengelola server MCP apa pun.

116 112 

129* **Mesin virtual terisolasi**: Setiap sesi cloud berjalan di VM yang terisolasi dan dikelola Anthropic125* **Mesin virtual terisolasi**: Setiap sesi cloud berjalan di VM yang terisolasi dan dikelola Anthropic

130* **Kontrol akses jaringan**: Akses jaringan dibatasi secara default dan dapat dikonfigurasi untuk dinonaktifkan atau hanya mengizinkan domain tertentu126* **Kontrol akses jaringan**: Akses jaringan dibatasi secara default dan dapat dikonfigurasi untuk dinonaktifkan atau hanya mengizinkan domain tertentu

131* **Perlindungan kredensial**: Kredensial GitHub disimpan terenkripsi di server Anthropic dan tidak pernah masuk ke VM sesi. VM menyimpan kredensial berumur pendek yang dibatasi untuk sesi tersebut, dan lalu lintas GitHub melewati [proxy Anthropic](/docs/id/cloud-environments#github-proxy) yang melampirkan kredensial GitHub di sisi server. Lihat [opsi autentikasi GitHub](/docs/id/claude-code-on-the-web#github-authentication-options) untuk cara Anda memberikan akses127* **Perlindungan kredensial**: Kredensial GitHub disimpan terenkripsi di server Anthropic dan tidak pernah masuk ke VM sesi. VM menyimpan kredensial berumur pendek yang dibatasi untuk sesi tersebut, dan lalu lintas GitHub melewati [proxy Anthropic](/docs/id/cloud-environments#github-proxy) yang melampirkan kredensial GitHub di sisi server. Lihat [opsi autentikasi GitHub](/docs/id/claude-code-on-the-web#github-authentication-options) untuk cara Anda memberikan akses

132* **Pembatasan cabang**: Operasi git push dibatasi pada cabang kerja saat ini128* **Pembatasan push**: [Proxy GitHub](/docs/id/cloud-environments#github-proxy) menolak penghapusan branch dan push apa pun selain branch, seperti tag. GitHub menentukan branch mana yang dapat diperbarui oleh sesi dengan menerapkan aturan perlindungan branch dan ruleset repositori Anda pada akses GitHub yang Anda hubungkan. Aturan yang dapat dilewati oleh akses tersebut tidak memblokir push dari sesi

133* **Pencatatan audit**: Semua operasi di sesi cloud dicatat untuk kepatuhan dan tujuan audit129* **Pencatatan audit**: Semua operasi di sesi cloud dicatat untuk kepatuhan dan tujuan audit

134* **Pembersihan otomatis**: VM sesi diklaim kembali setelah periode tidak aktif130* **Pembersihan otomatis**: VM sesi diklaim kembali setelah periode tidak aktif

135* **Penghapusan**: Anda dapat [menghapus sesi](/docs/id/claude-code-on-the-web#delete-sessions) kapan saja. Lihat [Alur data eksekusi cloud](/docs/id/data-usage#cloud-execution-data-flow-and-dependencies) untuk mengetahui apa yang Anthropic simpan untuk sesi cloud131* **Penghapusan**: Anda dapat [menghapus sesi](/docs/id/claude-code-on-the-web#delete-sessions) kapan saja. Lihat [Alur data eksekusi cloud](/docs/id/data-usage#cloud-execution-data-flow-and-dependencies) untuk mengetahui apa yang Anthropic simpan untuk sesi cloud