Memicu routine melalui API

Claude Code adalah alat pengodean agentik dari Anthropic. Claude Code on the web menjalankan sesi Claude Code pada infrastruktur cloud yang dikelola Anthropic di claude.ai/code, dan sebuah routine adalah konfigurasi tersimpan di sana: sebuah prompt, satu atau beberapa repositori, dan konektor, yang dikemas agar dapat berjalan tanpa pengawasan sesuai jadwal, sebagai respons terhadap peristiwa GitHub, atau ketika dipanggil melalui HTTP.

Endpoint ini adalah titik masuk HTTP. Mengirim POST ke endpoint ini akan memulai eksekusi baru dari routine yang sudah ada dan mengembalikan ID sesi serta URL yang dihasilkan. Pemanggil yang umum adalah sistem peringatan, pipeline CI, dan alat internal yang perlu memulai sesi Claude Code secara terprogram.

Memanggil endpoint ini memerlukan akun claude.ai pada paket Pro, Max, Team, atau Enterprise dengan Claude Code on the web yang diaktifkan. Autentikasi dilakukan dengan bearer token per-routine yang dibuat di UI web Claude Code, bukan dengan kunci API Claude.



Perbedaan dari Claude Platform

Endpoint pemicu routine termasuk dalam permukaan produk Claude Code, yang berbeda dari API dan SDK Claude Platform dalam beberapa hal:



Sebelum Anda mulai

Untuk memanggil endpoint ini, Anda memerlukan:

1. Sebuah routine yang dibuat di claude.ai/code/routines
2. Sebuah bearer token yang dihasilkan untuk routine tersebut: buka routine untuk diedit, klik Add another trigger di bawah Select a trigger, pilih API, lalu klik Generate token di modal. Token hanya ditampilkan sekali dan tidak dapat diambil kembali nanti.

Lihat Add an API trigger di dokumentasi Claude Code untuk panduan penyiapan lengkap.



Memicu routine

POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire

Setiap permintaan harus menyertakan header anthropic-beta: experimental-cc-routine-2026-04-01. Permintaan tanpa header tersebut akan mengembalikan 400 invalid_request_error.

UI web Claude Code menyediakan URL lengkap bersama dengan token saat Anda menambahkan pemicu API, sehingga sebagian besar integrasi menyimpan keduanya sebagai secret dan memanggil endpoint secara langsung. Contoh di bawah ini menunjukkan panggilan shell dan langkah GitHub Actions yang memicu routine saat CI gagal.

curl -X POST https://api.anthropic.com/v1/claude_code/routines/$ROUTINE_ID/fire \
  -H "Authorization: Bearer $ROUTINE_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

- if: failure()
  env:
    ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }}
    ROUTINE_FIRE_TOKEN: ${{ secrets.ROUTINE_FIRE_TOKEN }}
  run: |
    curl -X POST "$ROUTINE_FIRE_URL" \
      -H "Authorization: Bearer $ROUTINE_FIRE_TOKEN" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
      -H "Content-Type: application/json" \
      -d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"

Permintaan akan kembali setelah sesi dibuat. Permintaan ini tidak melakukan streaming output sesi atau menunggu sesi selesai.



Header



Parameter path



Body permintaan

Body bersifat opsional. Field yang tidak dikenal dalam body akan diabaikan.



Respons

Permintaan yang berhasil mengembalikan 200 OK dengan detail sesi baru:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}



Error

Error menggunakan envelope error standar Anthropic:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "<string>"
  }
}



Autentikasi

Bearer token dibatasi cakupannya untuk satu routine. Token yang bocor hanya dapat memicu routine tersebut; token tidak memberikan akses baca, akses ke routine lain, maupun akses ke data akun.

Buat dan cabut token dari pengaturan pemicu API routine di claude.ai/code/routines. Tidak ada API publik untuk manajemen token. Membuat token baru akan mencabut token sebelumnya.



Idempotensi

Setiap permintaan yang berhasil membuat sesi baru. Tidak ada kunci idempotensi. Jika pemanggil webhook melakukan percobaan ulang, endpoint akan membuat beberapa sesi.



Batas laju

Eksekusi routine dihitung terhadap jatah harian per-akun yang bervariasi berdasarkan paket, dan sesi yang dihasilkan mengurangi penggunaan langganan Claude Code yang sama seperti sesi interaktif. Ketika salah satu batas tercapai, endpoint mengembalikan 429 rate_limit_error dengan header Retry-After. Organisasi dengan penggunaan ekstra yang diaktifkan dapat melanjutkan melewati jatah yang disertakan dengan kelebihan penggunaan terukur.

Sisa eksekusi harian Anda ditampilkan di claude.ai/code/routines. Untuk mengetahui bagaimana penggunaan routine berinteraksi dengan batas langganan dan penagihan penggunaan ekstra, lihat Usage and limits di dokumentasi Claude Code.



Dukungan SDK

Endpoint ini tidak tersedia di SDK Anthropic. Model tokennya berbeda dari autentikasi kunci API, dan pemanggil yang umum seperti job CI dan webhook peringatan mengirim permintaan secara langsung.



Lihat juga

• Automate work with routines di dokumentasi Claude Code
• Header beta
• Error