Selama ni korang guna Claude Code sendiri: korang taip arahan, AI buat kerja.
Agent SDK ialah langkah seterusnya: enjin Claude Code tu dibungkus supaya
program korang sendiri boleh guna dia, tanpa ada manusia duduk menaip.
Ini teknologi di sebalik agent yang jalan sendiri setiap pagi, semak fail sendiri,
dan siapkan laporan sendiri. Bab ni terangkan apa dia, bila perlu, dan macam mana
nak mula dengan selamat.
Claude Code = kedai makan siap. Agent SDK = dapur kedai tu, yang boleh kau pasang dalam bangunan sendiri.
SDK bermaksud "software development kit": satu kotak alat untuk orang yang nak bina
program. Claude Agent SDK ialah Claude Code yang dibungkus jadi kotak
alat: gelung agent yang sama, tools yang sama (baca fail, tulis fail, jalankan arahan),
otak yang sama. Bezanya, yang mengarahnya bukan lagi jari korang di terminal, tapi
program yang korang tulis.
✗ Bukan "bad", ini CLAUDE CODE
Kau buka terminal, taip "susunkan folder resit aku ikut bulan", tengok dia kerja, jawab soalan dia. Ada MANUSIA dalam gelung, setiap kali.
✓ Ini AGENT SDK
Kau tulis skrip 10 baris yang suruh benda SAMA. Skrip tu boleh jalan setiap malam pukul 3 pagi, masa kau tidur. TIADA manusia dalam gelung.
Satu ayat untuk diingat: Agent SDK = Claude Code tanpa keyboard. Semua kuasa yang korang dah rasa di terminal, kini boleh dipanggil oleh program.
Modul 2 — 3 tingkat guna Claude
Jangan naik tangga sebelum perlu. Kebanyakan kerja selesai di tingkat 1 dan 2.
Ramai orang lompat terus nak "bina agent" padahal kerja dia selesai dengan chat biasa.
Kenali 3 tingkat ni, dan naik hanya bila tingkat bawah dah tak cukup:
✓ 3 tingkat, dari senang ke berkuasa
1. CLAUDE APPSChat dalam browser atau telefon (cabang Claude Apps). Tanya, dapat jawapan. Sesuai untuk 80% kerja harian: tulis caption, semak ayat, brainstorm.
2. CLAUDE CODETerminal (Claude Code). AI yang boleh SENTUH fail dan sistem kau, dengan kau memerhati. Sesuai untuk kerja sebenar atas komputer: kemas data, bina website, urus fail.
3. AGENT SDKKuasa tingkat 2, dalam program sendiri. Sesuai bila kerja tu BERULANG dan kau nak ia jalan TANPA kau: setiap pagi, setiap kali fail baru masuk, setiap kali pelanggan hantar borang.
Ujian senangTanya diri: "kerja ni aku buat sekali, atau berulang-ulang?" Sekali = tingkat 1 atau 2 cukup. Berulang dengan corak sama = baru berbaloi fikir tingkat 3. Ini sama dengan tapisan automasi yang korang belajar dalam subjek Automasi.
Modul 3 — Apa yang datang siap dalam kotak
Ingat anatomi agent dari subjek Automasi: brief + tools + gelung? SDK bagi tools dan gelung SIAP. Kau tulis brief sahaja.
Kalau bina agent dari kosong guna API biasa, kau kena tulis sendiri gelung dia
(fikir, buat, semak, ulang), bina setiap tool satu-satu, dan urus ingatan perbualan.
Agent SDK bagi semua tu siap pasang:
✓ Isi kotak Agent SDK
GELUNG AGENTFikir, pilih tool, tengok hasil, fikir lagi, sampai siap. Kau tak tulis satu baris pun untuk ini.
TOOLS SIAPBaca fail, tulis fail, edit fail, jalankan arahan terminal, cari fail dalam folder, cari maklumat di web. Tangan yang sama macam Claude Code.
URUS INGATANPerbualan panjang diringkaskan sendiri supaya agent tak "penuh otak" separuh jalan (konsep konteks dari Claude Code).
KEBENARANSistem permission: kau tentukan apa agent boleh buat sendiri dan apa kena minta izin. Ini pagar keselamatan paling penting (Modul 6).
SAMBUNGANBoleh tambah tangan baru melalui MCP (contoh: baca database kedai, hantar mesej) dan boleh pecahkan kerja besar kepada beberapa sub-agent.
Modul 4 — Kod pertama kau: query()
Satu fungsi utama sahaja perlu diingat. Kau bagi arahan, dia pulangkan cerita kerja dia langkah demi langkah.
Agent SDK ada dalam dua bahasa: Python dan TypeScript
(JavaScript). Kita tunjuk Python sebab paling senang dibaca. Pintu masuknya satu
fungsi bernama query(): kau hantar prompt, dia jalankan seluruh gelung
agent dan lapor balik apa yang dia buat.
Pasang (sekali sahaja)
pip install claude-agent-sdk
agent_pertama.py
import asyncio
from claude_agent_sdk import query
async def main():
async for mesej in query(
prompt="Baca fail jualan.csv dalam folder ni dan senaraikan 5 produk paling laku"
):
print(mesej)
asyncio.run(main())
Bila skrip ni jalan, agent akan cari fail tu, baca isinya, kira, dan cetak jawapan.
Sama macam korang taip arahan tu dalam Claude Code, cuma kali ni skrip yang menaip.
Untuk jalan, komputer kau perlu ada Claude Code dipasang dan akaun yang aktif
(setup penuh ada dalam Claude Code Fast Track).
Nota jujurNama fungsi dan cara pasang boleh berubah bila versi baru keluar. Bab ni ajar KONSEP yang kekal; untuk kod terkini, sentiasa rujuk dokumentasi rasmi di code.claude.com/docs/en/agent-sdk. Malah, cara paling pantas: buka Claude Code dan minta dia tuliskan skrip Agent SDK untuk kau, dia tahu versi semasa.
Modul 5 — Setting penting: brief, tangan, kebenaran
query() terima "options": tempat kau bentuk watak agent dan hadkan kuasanya.
Prompt ialah arahan untuk SATU kerja. Options pula ialah peraturan tetap
agent tu, sama macam brief pekerja baru: siapa dia, apa dia boleh sentuh, bila dia
kena tanya dulu. Empat setting yang paling kerap kau sentuh:
✓ 4 setting utama
SYSTEM PROMPTWatak dan peraturan tetap. Contoh: "Kau pembantu akaun kedai. Jangan sekali-kali ubah fail asal; tulis hasil ke folder output sahaja." Semua ilmu subjek Prompting Prompting terpakai bulat-bulat di sini.
FOLDER KERJATetapkan folder mana agent beroperasi. Bagi dia SATU folder khusus, bukan seluruh komputer.
SENARAI TOOLSPilih tangan mana dibenarkan. Agent yang kerjanya BACA laporan tak perlu tool tulis fail atau jalankan arahan. Kurang tangan = kurang risiko.
MOD KEBENARANTentukan bila agent kena berhenti dan minta izin. Masa mula-mula: paling ketat. Bila dah percaya (lepas berminggu jalan elok): baru longgarkan sikit demi sikit.
Modul 6 — Keselamatan: agent ni ada tangan sebenar
Chatbot silap jawab = malu. Agent silap bertindak = fail hilang. Layan dia macam pekerja baru yang belum kau kenal.
Agent SDK boleh tulis fail, padam fail, dan jalankan arahan atas komputer sebenar.
Itulah gunanya, dan itulah bahayanya. Empat pagar dari subjek Automasi terpakai di sini,
dengan bentuk yang lebih spesifik:
✗ Cara bahaya
Agent dilepaskan atas seluruh komputer, semua tools terbuka, tiada mod kebenaran, terus jalan atas data sebenar hari pertama, kunci API ditampal dalam kod.
✓ Cara selamat
Satu folder ujian dengan SALINAN data. Tools minimum. Mod kebenaran ketat. Kunci API dalam fail persekitaran, bukan dalam kod. Kau baca log setiap hari untuk minggu pertama.
Peraturan salinanMinggu pertama mana-mana agent baru: dia hanya boleh sentuh SALINAN data, bukan yang asal. Bila 7 hari berturut hasil dia betul, baru pertimbangkan bagi data sebenar. Sama macam pekerja baru tak terus pegang kunci kedai.
Modul 7 — Contoh guna-kes untuk bisnes kecil
Tool tanpa kod (Make, n8n) untuk sambung app ke app. Agent SDK bila kerjanya perlukan pertimbangan atas FAIL kau.
Dalam subjek Automasi korang kenal Make dan n8n. Bila pula Agent SDK jadi pilihan yang betul?
Bila kerja tu melibatkan fail dan folder di komputer kau, dan perlukan AI yang
berfikir sepanjang jalan, bukan sekadar pindah data dari app A ke app B:
✓ 4 contoh sesuai kedai kecil
1Laporan pagi: setiap 7:30, agent baca fail jualan semalam, cari benda pelik (jualan jatuh, stok lari), tulis ringkasan 5 baris untuk owner.
2Kemas resit: agent semak folder "resit masuk", baca setiap gambar/PDF, namakan semula ikut tarikh dan kedai, susun ke folder bulan.
3Draf jawapan email: agent baca email pelanggan yang masuk, sediakan DRAF jawapan ikut gaya kedai. Manusia semak dan hantar (pagar: manusia sahkan).
4Semak website sendiri: seminggu sekali, agent buka website kedai, semak link mati dan harga tak padan dengan senarai harga, lapor apa yang perlu dibetulkan.
Perasan coraknya? Setiap satu ialah kerja BERULANG + melibatkan FAIL + perlukan PERTIMBANGAN. Itu zon Agent SDK.
Modul 8 — Projek mini pertama kau
Satu agent kecil, atas folder ujian, jalan 7 hari. Itu sahaja matlamatnya.
Prasyarat: dah habis Claude Code (Claude Code berjalan di komputer kau) dan subjek Prompting
(asas prompting). Kalau dua-dua dah ada, ikut tangga ni:
✓ Tangga 5 langkah
1Sediakan folder ujian dengan beberapa fail salinan (contoh: 5 resit lama, atau satu fail jualan).
2Buka Claude Code dan minta dia: "Tuliskan skrip Agent SDK Python yang [kerja kau], beroperasi dalam folder ni sahaja, dengan permission paling ketat." Biar dia pasang dan uji sekali.
3Jalankan skrip tu sendiri 2-3 kali. Baca apa agent buat setiap kali. Betulkan brief kalau dia lari.
4Bila puas hati, jadualkan (subjek Automasi Modul 3: trigger masa) supaya dia jalan sendiri setiap hari.
5Pantau 7 hari. Jalan elok tanpa disentuh, dan kau tahu cara stop dia? Tahniah, kau dah bina agent sendiri.
Langkah seterusnyaDokumentasi rasmi (code.claude.com/docs/en/agent-sdk) ada contoh untuk sub-agent, MCP, dan sesi berpanjangan. Tapi jangan tergesa: satu agent kecil yang STABIL lebih bernilai dari lima agent hebat yang separuh siap.
Rumusan — Claude Code tanpa keyboard
Apa diaEnjin Claude Code, dibungkus untuk program sendiri.
3 tingkatApps untuk chat, Code untuk kerja, SDK untuk kerja berulang tanpa kau.