Managed Settings Claude Code: Kebijakan yang Benar-Benar Mengikat

Seorang administrator yang saya ajak bicara sudah mengirimkan file managed settings yang disusun rapi ke setiap mesin, memverifikasi JSON-nya, memverifikasi path-nya, dan tetap tidak paham kenapa tak satu pun berlaku. File-nya tidak bermasalah. Organisasi mereka juga sudah mengonfigurasi server-managed settings beberapa bulan sebelumnya, dan sumber itu mengalahkan sebuah file — jadi Claude Code membaca kebijakan remote dan diam-diam mengabaikan yang baru saja mereka kirim.

Managed settings adalah mekanisme yang membuat Claude Code bisa digelar di organisasi yang punya aturan, dan yang membuatnya membingungkan adalah ia tidak berperilaku seperti sisa sistem setting. Tulisan ini membahas empat mekanisme pengirimannya, prioritas menang-mutlak beserta pengecualiannya, key yang hanya bisa disetel sumber managed, apa yang terjadi ketika sebuah nilai tidak valid, dan dua perintah yang menjawab apakah kebijakan itu benar-benar berlaku.

Empat cara mengirimkan key yang sama

Setiap mekanisme membawa policy key yang sama seperti file setting biasa, jadi referensi setting berlaku untuk semuanya. Yang berbeda adalah di mana kebijakannya disimpan dan kapan Claude Code membacanya. Baris file dan MDM bersama-sama disebut endpoint-managed, karena kebijakannya tersimpan di perangkat; server-managed adalah baris tempat Claude Code justru mengambilnya.

Pilih berdasarkan cara Anda sudah mengelola perangkat:

# managed-settings.json goes in the system directory for the OS.
# Note that the legacy Windows ProgramData path is NOT read.

  macOS            /Library/Application Support/ClaudeCode/
  Linux and WSL    /etc/claude-code/
  Windows          C:\Program Files\ClaudeCode\

# Same directory also holds an optional drop-in directory and
# the managed MCP configuration:
#   managed-settings.d/*.json
#   managed-mcp.json

# Drop-ins let several teams own parts of one policy. Claude Code
# merges managed-settings.json first, then every .json file in the
# directory in ALPHABETICAL order — so prefix them:
#   10-telemetry.json
#   20-security.json

Aturan prioritas yang menjegal semua orang

Inilah bagian yang layak dibaca dua kali. Claude Code memeriksa sumbernya dengan urutan tetap dan memakai yang pertama memuat setidaknya satu policy key. Ia tidak menggabungkan sisanya — ia mengabaikannya, tanpa peringatan:

1. Remote settings, dari claude.ai atau Claude apps gateway. Hanya diambil ketika sesi melakukan autentikasi langsung ke Anthropic API dengan login yang memenuhi syarat, jadi di provider lain Claude Code memulai dari sumber berikutnya.
2. Kebijakan MDM atau level OS — domain managed preferences macOS atau key registry level mesin di Windows.
3. File managed settings, dengan direktori drop-in ikut digabungkan.
4. Registry Windows yang bisa ditulis pengguna, dibaca hanya ketika tidak ada di atasnya yang memuat policy key.

Key yang tetap dibaca dari setiap sumber

Sekumpulan kecil key melanggar aturan menang-mutlak itu, karena mereka berupa lock atau kontrol keamanan tempat nilai yang lebih ketat dari mana pun seharusnya menang. Claude Code membacanya dari setiap admin source — yang tidak mencakup registry yang bisa ditulis pengguna:

• Lock sandbox untuk managed domain dan managed read path. Nilai true di admin source mana pun menyalakan lock-nya, dan selama menyala, allowlist-nya digabung dari setiap admin source.
• Beberapa kontrol sandbox dan path binary-nya, plus flag yang memaksa pengambilan ulang remote settings saat startup.
• Blok environment, digabung per variabel sejak v2.1.223 — tiap variabel berasal dari sumber berprioritas tertinggi yang mendefinisikannya, sehingga sumber lebih rendah mengisi celahnya alih-alih dibuang.

Menulis kebijakan yang benar-benar membatasi sesuatu

Sebagian besar key khusus managed adalah lock. Nilai yang diatur sebuah lock — permission rule, domain sandbox — adalah key biasa yang bisa disetel level mana pun; lock-lah yang memberi tahu Claude Code untuk hanya menghormati nilai managed. Mengirimkan aturan tanpa lock yang bersesuaian adalah cara paling umum sebuah kebijakan berakhir sebagai saran alih-alih ikatan.

// A managed policy that actually constrains something.
{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./secrets/**)"],
    "disableBypassPermissionsMode": "disable"
  },
  // Without this, a developer's own allow rules still apply
  // alongside yours. With it, ONLY managed rules count — and
  // --allowedTools is ignored too.
  "allowManagedPermissionRulesOnly": true
}

# Confirm it landed on one machine before the fleet:
/status        # look for the "Setting sources" line
               #   Enterprise managed settings (file)
               #   ... (remote) (plist) (HKLM) (drop-ins) (HKCU)
               #   ... (parent process) (helper)

claude doctor  # lists every entry Claude Code DROPPED, with
               # its source and field

Ada daftar panjang key khusus managed di luar permission: kontrol untuk hook mana yang boleh berjalan, MCP server mana yang diterima, marketplace plugin mana yang diizinkan, apakah plugin bersumber command boleh berjalan sama sekali, apakah flag sideload ditolak saat startup, dan apakah skill, agent, hook, serta MCP server boleh datang dari sumber user dan project. Referensi setting menandai masing-masing, dan baris scope adalah kolom yang perlu dibaca.

Nilai tidak valid tidak semuanya gagal dengan cara yang sama

Claude Code sengaja toleran terhadap managed settings: ia memperbaiki yang bisa diperbaiki, membuang key tingkat atas yang tetap gagal, dan terus menegakkan semua yang valid. Segelintir key penegakan menolak dibuang, karena membuangnya justru hasil yang tidak aman:

• Allowlist MCP server yang tidak valid ditegakkan sebagai allowlist kosong, sehingga tidak ada server yang diterima sampai diperbaiki.
• Allowlist model yang tidak valid juga ditegakkan sebagai kosong, menyisakan hanya model default.
• Key managed-hooks-only, managed-MCP-only, dan sumber plugin command semuanya diperlakukan sebagai true ketika tidak valid.
• Batas versi minimum dan maksimum justru sengaja gagal terbuka, supaya kiriman kebijakan yang keliru tidak bisa menghentikan Claude Code dari berjalan sama sekali.

Apa yang masih bisa diubah developer

Managed settings memang kuat, dan layak jujur soal empat hal yang berada di luarnya, karena tinjauan keamanan pasti menanyakannya:

• Model untuk sebuah sesi. Nilai model managed adalah default, bukan kunci — flag dan environment variable tetap memilih modelnya, jadi kirimkan allowlist model untuk membatasi pilihannya.
• Hak administrator lokal. Orang yang menjadi admin di mesin itu bisa mengedit sumber managed-nya sendiri, dan justru itulah sebabnya perkakas MDM mengirim ulang secara terjadwal.
• Cache server-managed, tempat sebuah edit lokal hanya bertahan sampai pengambilan berikutnya berhasil.
• Perkakas lain sama sekali. Managed settings mengikat Claude Code, bukan developer yang memanggil API dari alat lain.

Menjawab apakah ia benar-benar berlaku

Dua perintah menuntaskan setiap versi pertanyaan ini. Baris setting-sources pada perintah status menyebutkan sumber managed yang dipilih Claude Code, di dalam kurung, sehingga Anda tahu sekaligus bahwa sebuah kebijakan aktif dan mekanisme mana dari empat itu yang menang. Baris yang hilang berarti tidak ada sumber yang mengirimkan policy key sama sekali; baris yang menyebut sumber lain berarti ada sumber berprioritas lebih tinggi dan milik Anda diabaikan.

Perintah doctor menjawab separuh lainnya: apa yang terbuang. Ketika sebuah file, profil, nilai registry, atau payload server gagal validasi skema, Claude Code melewati entri yang bisa diperbaikinya dengan satu peringatan masing-masing, lalu membuang key tingkat atas yang nilainya tetap gagal. Sesi interaktif menampilkan dialog saat startup, run non-interaktif mencetak ke standard error, dan perintah doctor mendaftar tiap entri tidak valid beserta sumber dan field-nya.

Aturan yang perlu dibawa pulang: managed settings bukan penggabungan, melainkan pemilihan. Putuskan mana dari empat mekanisme itu yang menjadi sumber kebenaran Anda, kirimkan hanya lewat mekanisme tersebut, dan verifikasi lewat baris status di satu mesin sebelum menyentuh seluruh armada. Lalu pasangkan setiap aturan dengan lock yang membuatnya mengikat, karena permission rule tanpa lock-nya hanyalah saran — dan saran bukan yang ingin dikirim siapa pun yang menggelar managed settings.