Memicu routine melalui API

Claude Code adalah alat pengodean agentik dari Anthropic. Claude Code di web menjalankan sesi Claude Code pada infrastruktur cloud yang dikelola Anthropic di claude.ai/code, dan routine adalah konfigurasi tersimpan di sana: sebuah prompt, satu atau beberapa repositori, dan konektor, yang dikemas sehingga 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 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 dengan paket Pro, Max, Team, atau Enterprise dengan Claude Code di web diaktifkan. Lakukan autentikasi dengan bearer token per-routine yang dibuat di UI web Claude Code, bukan dengan "API key" (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 memulai

Untuk memanggil endpoint ini, Anda memerlukan:

1. Sebuah routine yang dibuat di claude.ai/code/routines.
2. 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 jendela modal. Token hanya ditampilkan sekali dan tidak dapat diambil kembali nanti.

Lihat Menambahkan pemicu API 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 mengembalikan 400 invalid_request_error.

UI web Claude Code menyediakan URL lengkap bersama token saat Anda menambahkan pemicu API, sehingga sebagian besar integrasi menyimpan keduanya sebagai secret dan memanggil endpoint secara langsung. Contoh berikut menunjukkan pemanggilan 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 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 amplop error standar Anthropic:

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

Autentikasi

Bearer token dicakup ke satu routine saja. Token yang bocor hanya dapat memicu routine tersebut; token tidak memberikan akses baca, tidak memberikan akses ke routine lain, dan tidak memberikan akses ke data akun.

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

Idempotensi

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

Batas laju

Eksekusi routine dihitung terhadap jatah harian per-akun yang bervariasi menurut 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.

Lihat sisa eksekusi harian Anda di claude.ai/code/routines. Untuk mempelajari bagaimana penggunaan routine berinteraksi dengan batas langganan dan penagihan penggunaan ekstra, lihat Penggunaan dan batas 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

• Mengotomatiskan pekerjaan dengan routine di dokumentasi Claude Code
• Header beta
• Error