Pengaturan

settings.json membawa konfigurasi harness Claude Code: pengabelan hook, izin tool, variabel lingkungan, dan pengaturan baris status.

Referensi kanonik lengkap berada di settings-reference.md. Halaman ini meringkas kontraknya dan menunjuk ke referensi yang lebih mendalam.

BagianCopy Anchor Link

Invarian templat tunggalCopy Anchor Link

Adapter Claude Code mengirimkan satu templat settings.json. Perintah hook menggunakan bentuk exec (command ditambah args) alih-alih string perintah khusus shell, sehingga perilaku lintas OS ditinjau di dalam satu berkas. Entri izin dan peristiwa hook yang baru masuk ke berkas tersebut secara atomik.

Menggabungkan ke dalam berkas pengaturan Anda sendiriCopy Anchor Link

settings.json juga merupakan berkas Anda. Instalasi menggabungkan templat ke dalamnya alih-alih menggantinya, dan mencatat di ledger instalasi (~/.apothem/state/<harness>/ledger.jsonl) secara persis kunci dan entri daftar mana yang ditambahkannya:

• permissions.allow dan permissions.deny digabungkan sebagai union: aturan Anda tetap berada di depan dan aturan Apothem ditambahkan di belakangnya. Aturan deny yang Anda tulis selalu dipertahankan, dan Claude Code menerapkan aturan deny sebelum aturan allow.
• Handler hook Anda sendiri tetap di tempatnya. Sebuah handler dianggap milik Apothem hanya jika handler tersebut menjalankan skrip yang dipasang Apothem di bawah root harness, sehingga handler yang memanggil hooks/dispatch.py lain adalah milik Anda.
• Instalasi ulang hanya mengganti apa yang ditambahkan Apothem pada instalasi sebelumnya, sehingga entri yang tidak lagi ada di templat akan dihapus dan entri yang Anda tambahkan dipertahankan.
• Pencopotan hanya menghapus entri yang dicatat ledger sebagai milik Apothem. Aturan yang kebetulan sama dengan salah satu aturan Apothem (misalnya Read dalam daftar allow Anda sendiri sebelum instalasi pertama) tetap ada. Berkas tersebut hanya dihapus ketika Apothem yang membuatnya dan tidak ada lagi milik Anda yang tersisa di dalamnya.

Aturan yang sama berlaku untuk berkas pengaturan lain yang digabungkan oleh Apothem, seperti peta server MCP di settings.json milik Qwen Code dan opencode.json milik OpenCode.