Claude Platform Docs

Scripting dan otomatisasi CLI

Kelola versi sumber daya API sebagai YAML, rangkai perintah CLI ant dalam skrip, operasikan sumber daya dari Claude Code, dan autentikasi panggilan curl dengan kredensial 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 (version control) sumber daya API seperti skill, agen, environment, atau deployment sebagai file YAML di repositori Anda dan menjaganya tetap sinkron dengan Claude API.

  1. Definisikan agen Anda

    Tulis definisi agen ke summarizer.agent.yaml:

    summarizer.agent.yaml
    name: Summarizer
model: claude-opus-5
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

  2. Buat agen

    ant beta:agents create < summarizer.agent.yaml
    Output
    {
  "id": "agent_011CYm1BLqPXpQRk5khsSXrs",
  "version": 1,
  "name": "Summarizer",
  "model": "claude-opus-5"
  /* ... */
}

    Catat id dari respons. Anda akan meneruskannya ke perintah pembuatan sesi pada langkah berikutnya.

  3. Definisikan environment

    Sebuah sesi berjalan dalam sebuah environment, yang mendefinisikan sandbox tempat sesi tersebut dieksekusi. Tulis definisi environment ke summarizer.environment.yaml:

    summarizer.environment.yaml
    name: summarizer-env
config:
  type: cloud
  networking:
    type: unrestricted

  4. Buat environment

    ant beta:environments create < summarizer.environment.yaml
    Output
    {
  "id": "env_01595EKxaaTTGwwY3kyXdtbs",
  "name": "summarizer-env"
  /* ... */
}

    Catat id dari respons. Anda akan meneruskannya ke perintah pembuatan sesi pada langkah berikutnya.

  5. Mulai sesi

    Tempelkan id agen dan id environment dari output sebelumnya ke perintah pembuatan sesi:

    ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"
    Output
    {
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

  6. Kirim pesan pengguna

    Salin id sesi dari output sebelumnya ke --session-id:

    ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

  7. Baca percakapan

    --transform dijalankan terhadap setiap event yang terdaftar, sehingga ini mencetak teks dari setiap pesan secara berurutan. --format auto menimpa explorer interaktif yang secara default dibuka oleh perintah list di terminal:

    ant beta:sessions:events list \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --transform 'content.0.text' --format auto --raw-output
    Output
    Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.

Pola scripting

CLI dirancang agar dapat dikombinasikan dengan perangkat 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. Ambil 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-nya:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1
Output
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 tanpa konfigurasi tambahan. Dengan CLI yang sudah terinstal dan terautentikasi, Anda dapat meminta Claude Code untuk mengoperasikan sumber daya API Anda secara langsung. Misalnya:

  • "Tampilkan daftar sesi agen terbaru saya dan rangkum mana saja 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 tersebut macet."

Claude Code memanggil ant melalui shell, mem-parsing output terstrukturnya, dan menalar hasilnya (tanpa memerlukan kode integrasi khusus).

Mengautentikasi permintaan curl dengan kredensial CLI

Skrip yang memanggil API dengan curl atau klien HTTP lain dapat menggunakan kredensial yang disimpan oleh ant auth login alih-alih "API key" (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 profil aktif, dengan memperbaruinya terlebih dahulu jika sudah kedaluwarsa atau hampir kedaluwarsa:

cURL
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 memastikan organisasi dan workspace mana yang sedang Anda gunakan untuk login; perintah ini memberi peringatan ketika sebuah variabel environment menimpa login Anda.

Was this page helpful?