Scripting dan otomatisasi CLI

Halaman ini membahas alur kerja berorientasi tugas yang dibangun di atas CLI ant. Untuk flag dan opsi output yang mendasarinya, lihat Menggunakan CLI.



Mengelola versi sumber daya API

Anda dapat menggunakan CLI untuk mengelola versi sumber daya API seperti skill, agen, environment, atau deployment sebagai file YAML di repositori Anda dan menjaganya tetap sinkron dengan Claude API.



Pola scripting

CLI dirancang untuk dapat dikomposisikan dengan perkakas shell standar.



Merangkai output list ke perintah kedua

--transform id --raw-output pada endpoint list menghasilkan satu ID polos per baris, sehingga alat standar seperti head dan xargs dapat langsung diterapkan. Tangkap hasil pertama, lalu teruskan ke perintah lanjutan:

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl



Memeriksa error

Flag --transform-error dan --format-error menerapkan pemfilteran yang sama pada respons error. --raw-output tidak berlaku untuk error, jadi gunakan --format-error yaml untuk skalar tanpa tanda kutip. Ekstrak hanya pesan error:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.



Menggunakan CLI dari Claude Code

Claude Code dapat menggunakan CLI ant secara langsung. Dengan CLI terpasang dan terautentikasi, Anda dapat meminta Claude Code untuk mengoperasikan sumber daya API Anda secara langsung. Sebagai contoh:

• "Daftar sesi agen terbaru saya dan rangkum mana yang mengalami error."
• "Unggah setiap PDF di ./reports ke Files API dan cetak ID yang dihasilkan."
• "Ambil event untuk sesi session_01... dan beri tahu saya di mana agen mengalami kebuntuan."

Claude Code menjalankan ant melalui shell, mem-parsing output terstruktur, dan melakukan penalaran atas hasilnya (tanpa memerlukan kode integrasi khusus).



Autentikasi permintaan curl dengan kredensial CLI

Skrip yang memanggil API dengan curl atau klien HTTP lainnya dapat menggunakan kredensial yang disimpan oleh ant auth login alih-alih kunci API statis. Token akses OAuth ditempatkan di header Authorization sebagai bearer token; header x-api-key hanya untuk kunci API statis.

ant auth print-credentials --access-token mencetak token akses dari profil aktif, menyegarkannya terlebih dahulu jika sudah kedaluwarsa atau mendekati kedaluwarsa:

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'

Jalankan ant auth status untuk mengonfirmasi organisasi dan workspace mana yang sedang Anda gunakan untuk login; perintah ini memberi peringatan ketika sebuah variabel lingkungan menimpa login Anda.