Otomatisasi tindakan dengan hooks

Hooks adalah perintah shell yang ditentukan pengguna. Claude Code menjalankannya pada titik-titik spesifik dalam siklus hidupnya, yang memberikan Anda kontrol deterministik: tindakan tertentu selalu terjadi daripada mengandalkan LLM untuk memilih menjalankannya. Gunakan hooks untuk menegakkan aturan proyek, mengotomatisasi tugas berulang, dan mengintegrasikan Claude Code dengan alat yang sudah ada. Untuk keputusan yang memerlukan penilaian daripada aturan deterministik, Anda juga dapat menggunakan prompt-based hooks atau agent-based hooks yang menggunakan model Claude untuk mengevaluasi kondisi. Untuk cara lain memperluas Claude Code, lihat skills untuk memberikan Claude instruksi tambahan dan perintah yang dapat dieksekusi, subagents untuk menjalankan tugas dalam konteks terisolasi, dan plugins untuk mengemas ekstensi untuk dibagikan di seluruh proyek.

Panduan ini mencakup kasus penggunaan umum dan cara memulai. Untuk skema acara lengkap, format input/output JSON, dan fitur lanjutan seperti async hooks dan MCP tool hooks, lihat Hooks reference.

Siapkan hook pertama Anda

Untuk membuat hook, tambahkan blok hooks ke file pengaturan. Panduan ini membuat hook notifikasi desktop, sehingga Anda mendapat peringatan kapan pun Claude menunggu input Anda daripada menonton terminal.

Tambahkan hook ke pengaturan Anda

Buka ~/.claude/settings.json dan tambahkan hook Notification. Jika file tidak ada, buatlah. Contoh di bawah menggunakan osascript untuk macOS; lihat Dapatkan notifikasi ketika Claude memerlukan input untuk perintah Linux dan Windows.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

Jika file pengaturan Anda sudah memiliki kunci hooks, tambahkan Notification sebagai sibling dari kunci acara yang ada daripada mengganti seluruh objek. Setiap nama acara adalah kunci di dalam objek hooks tunggal:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]
      }
    ],
    "Notification": [
      {
        "matcher": "",
        "hooks": [{ "type": "command", "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'" }]
      }
    ]
  }
}

Anda juga dapat meminta Claude untuk menulis hook untuk Anda dengan mendeskripsikan apa yang Anda inginkan di CLI.

Verifikasi konfigurasi

Ketik /hooks di prompt Claude Code untuk membuka browser hooks. Hook baru Anda muncul dalam daftar di bawah Notification.

Uji hook

Tekan Esc untuk kembali ke CLI. Tekan Shift+Tab hingga bilah status menunjukkan ⏸ manual mode on, minta Claude untuk melakukan sesuatu yang memerlukan izin, kemudian beralih dari terminal. Anda harus menerima notifikasi desktop.

Apa yang dapat Anda otomatisasi

Hooks memungkinkan Anda menjalankan kode pada titik-titik kunci dalam siklus hidup Claude Code: format file setelah edit, blokir perintah sebelum dijalankan, kirim notifikasi ketika Claude memerlukan input, injeksi konteks saat awal sesi, dan banyak lagi. Untuk daftar lengkap acara hook, lihat Hooks reference. Setiap contoh mencakup blok konfigurasi siap pakai yang Anda tambahkan ke file pengaturan. Untuk contoh produksi hooks yang menjalankan review model terpisah dan mengirimkan temuan kembali ke sesi, lihat bagaimana plugin security-guidance terintegrasi dengan Claude Code.

Dapatkan notifikasi ketika Claude memerlukan input

Dapatkan notifikasi desktop kapan pun Claude selesai bekerja dan memerlukan input Anda, sehingga Anda dapat beralih ke tugas lain tanpa memeriksa terminal. Hook ini menggunakan acara Notification, yang Claude Code aktifkan ketika Claude menunggu input atau izin. Lihat kapan setiap jenis notifikasi aktif untuk waktu yang tepat. Setiap tab di bawah menggunakan perintah notifikasi asli platform. Tambahkan ini ke ~/.claude/settings.json:

macOS
Linux
Windows (PowerShell)

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

Jika tidak ada notifikasi yang muncul

osascript merutekan notifikasi melalui aplikasi Script Editor bawaan. Jika Script Editor tidak memiliki izin notifikasi, perintah gagal diam-diam, dan macOS tidak akan meminta Anda untuk memberikannya.Jalankan ini di Terminal sekali untuk membuat Script Editor muncul di pengaturan notifikasi Anda:

osascript -e 'display notification "test"'

Tidak ada yang akan muncul dulu. Buka System Settings > Notifications, temukan Script Editor dalam daftar, dan aktifkan Allow Notifications. Jalankan perintah lagi untuk mengonfirmasi notifikasi uji muncul.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Claude Code needs your attention'"
          }
        ]
      }
    ]
  }
}

Jika tidak ada notifikasi yang muncul

notify-send memerlukan daemon notifikasi desktop, yang tidak dimiliki server headless, sesi SSH, dan sebagian besar container. Uji perintah secara langsung terlebih dahulu:

notify-send 'Claude Code' 'test'

Jika perintah tidak ditemukan, instal paket libnotify-bin di Debian dan Ubuntu, atau yang setara dengan distribusi Anda.

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Jika tidak ada dialog yang muncul

Perintah ini membuka kotak dialog daripada notifikasi di sudut layar Anda, sehingga dialog dapat terbuka di belakang jendela terminal Anda. Uji perintah secara langsung di PowerShell terlebih dahulu.Jika Anda menjalankan Claude Code di dalam WSL, powershell.exe harus tersedia di PATH Anda melalui interop Windows.

Matcher kosong matcher aktif pada semua jenis notifikasi. Untuk aktif hanya pada acara tertentu, atur ke salah satu nilai berikut:

Matcher	Aktif ketika
`permission_prompt`	Claude memerlukan Anda untuk menyetujui penggunaan alat atau permintaan jaringan perintah sandboxed, dan prompt telah menunggu sekitar enam detik
`idle_prompt`	Claude selesai merespons sekitar 60 detik yang lalu dan Anda belum mengetik sejak saat itu
`auth_success`	Autentikasi selesai
`elicitation_dialog`	Server MCP membuka formulir elicitation dan Anda belum mengetik selama sekitar enam detik
`elicitation_url_dialog`	Server MCP meminta Anda untuk membuka URL browser dan Anda belum mengetik selama sekitar enam detik
`elicitation_complete`	Server MCP melaporkan bahwa elicitation mode URL selesai
`elicitation_response`	Respons elicitation MCP dikirim kembali ke server
`agent_needs_input`	Sesi latar belakang mulai menunggu input Anda saat agent view terbuka. Juga aktif ketika sesi terminal menunjukkan Anda pertanyaan terminal setup teammate tim agent atau pemberitahuan mode otomatis tentang biaya permintaan classifier dan Anda belum mengetik selama sekitar enam detik
`agent_completed`	Sesi latar belakang selesai atau gagal. Hanya aktif saat agent view terbuka
`quota_auto_resume_fired`	Claude Code melanjutkan tugas Anda setelah batas penggunaan claude.ai menjeda: saat reset, atau lebih cepat ketika sesuatu yang Anda lakukan di Claude Code selama menunggu, seperti menambahkan kredit penggunaan, meningkatkan paket, atau beralih model, membuat penggunaan tersedia lagi, dengan pengecualian pengaturan model
`quota_auto_resume_stale`	Batas penggunaan claude.ai reset saat komputer Anda tidur selama lebih dari sekitar 30 menit. Claude Code menunggu Anda menekan `Enter` daripada melanjutkan. Setelah tidur yang lebih singkat, Claude Code melanjutkan dan menampilkan `quota_auto_resume_fired` sebagai gantinya
`quota_auto_resume_disabled`	Claude Code mengakhiri penantiannya untuk batas penggunaan claude.ai tanpa melanjutkan tugas Anda: `autoContinueAtUsageLimit` dimatikan atau reset bergerak lebih dari 24 jam jauh selama menunggu Claude Code dimulai sendiri, tugas yang dilanjutkan terus mencapai batas, atau kelanjutan diblokir sebelum mencapai model. Tidak aktif ketika Anda menekan `Esc` atau `Ctrl+C`, atau memilih Don’t continue automatically

Claude Code mengatur waktu permission_prompt berbeda di terminal dan di Claude Desktop, ekstensi VS Code, dan host lain yang menjawab permintaan izin melalui Agent SDK. Lihat kapan setiap jenis notifikasi aktif untuk kedua waktu. Matcher quota_auto_resume_fired, quota_auto_resume_stale, dan quota_auto_resume_disabled memerlukan Claude Code v2.1.234 atau lebih baru. Dalam sesi terminal, permission_prompt untuk permintaan jaringan perintah sandboxed memerlukan Claude Code v2.1.246 atau lebih baru. agent_needs_input untuk pertanyaan terminal setup teammate memerlukan Claude Code v2.1.248 atau lebih baru. Ketik /hooks di prompt Claude Code dan konfirmasi bahwa hook muncul di bawah Notification.

Auto-format kode setelah edit

Jalankan Prettier secara otomatis pada setiap file yang Claude edit, sehingga pemformatan tetap konsisten tanpa intervensi manual. Hook ini menggunakan acara PostToolUse dengan matcher Edit|Write, sehingga hanya berjalan setelah alat pengeditan file. Perintah mengekstrak jalur file yang diedit dengan jq dan meneruskannya ke Prettier. Tambahkan ini ke .claude/settings.json di root proyek Anda:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Untuk menguji hook, minta Claude untuk menambahkan baris dengan string yang dikutip tunggal ke file JavaScript, kemudian buka file: dengan pengaturan default Prettier, hook menulis ulang ke tanda kutip ganda. Ketika hook berhasil, Claude Code tidak menampilkan apa pun dalam percakapan. Untuk mengonfirmasi hook berjalan, periksa bahwa file yang diedit diformat ulang, atau lihat Periksa apa yang dilakukan hook. Untuk memformat ulang file tertentu bagaimanapun perubahannya, termasuk ketika perintah Bash menulis ulangnya, gunakan hook FileChanged sebagai gantinya.

Contoh Bash di halaman ini menggunakan jq untuk parsing JSON. Instal dengan brew install jq di macOS, apt-get install jq di Debian dan Ubuntu, atau lihat

Agent dan pekerjaan paralel

MCP

Skills

Artifact

Otomatisasi

Panduan

Pemecahan masalah

Otomatisasi tindakan dengan hooks

Siapkan hook pertama Anda

Apa yang dapat Anda otomatisasi

Dapatkan notifikasi ketika Claude memerlukan input

Auto-format kode setelah edit

​Siapkan hook pertama Anda

​Apa yang dapat Anda otomatisasi

​Dapatkan notifikasi ketika Claude memerlukan input

​Auto-format kode setelah edit

Siapkan hook pertama Anda

Apa yang dapat Anda otomatisasi

Dapatkan notifikasi ketika Claude memerlukan input

Auto-format kode setelah edit