概念解說 · 2026-10-26

由零開始寫 AI Agent
Claude Agent SDK 實戰指南Write your first AI Agent with Claude Agent SDK in Python

本地中小企想試 AI 自動化?用官方 Claude Agent SDK 幾分鐘就可以寫出會識自己調用工具嘅 Agent。

重點摘要 · Key Takeaways

  • 資料完全留在本地,符合私隱要求
  • 無按月訂閱費,硬件回本後近乎免費
  • 離線可用,唔受網絡穩定性影響
  • 適合處理敏感數據或高頻重複任務

相關:工具包 · 更多文章 · 免費清單

安裝開發環境

確保電腦已經安裝 Python 同 pip,新建一個資料夾存放項目。

用終端機安裝 claude-agent-sdk-python,準備好 Anthropic API Key 以便後續連接。

準備工具函數

寫一個 Python 函數,例如查詢產品庫存或計算報價,讓 Agent 可以調用。

為函數加上清楚嘅說明,幫助 Claude 明白點樣正確使用呢個工具。

初始化 Agent 實例

導入 SDK 模組,建立 Agent 物件並傳入 Claude 模型名稱。

將剛才定義嘅工具函數註冊到 Agent 當中,使其可以被調用。

理解 Agent Loop 運作

Agent Loop 係 Claude 思考、調用工具、觀察結果再繼續思考嘅循環。

每次收到用戶訊息,Agent 會決定要唔要呼叫工具,直到得到最終答案為止。

啟動第一次對話

向 Agent 發送一個具體問題,例如查詢某款產品現時庫存。

觀察終端機輸出,確認 Agent 係否正確調用工具並回覆結果。

部署同優化建議

將本地測試成功嘅代碼部署到伺服器,加入錯誤處理同日誌記錄。

根據實際業務需要,增加更多工具函數擴展 Agent 能力。

常見問題

需要付費嗎?

SDK 本身免費,但使用 Claude API 會按 Anthropic 收費標準產生費用。

點解要用 Agent Loop?

Agent Loop 讓 AI 可以多步驟思考,自動決定調用邊個工具,處理複雜任務。

本地AI會唔會好慢?

對於日常文書、代碼生成同簡單對話,現代家用硬件嘅速度完全足夠,甚至因為無網絡延遲而感覺更順暢。

設置本地模型好難嗎?

以前需要寫程式,現在有唔少開箱即用嘅工具(如LM Studio、Ollama),幾分鐘內就可以開始運行模型。

我部機跑唔到點算?

可以嘗試量化模型(Quantized Models),佢哊體積細、記憶體需求低,喺普通電腦上都能跑動。

想睇實測?

免費清單每週更新本地 AI 工具對比,唔賣你 email。

Free download · 免費清單

免費 30 條粵語 WhatsApp 模板30 free Cantonese WhatsApp templates

留低 email,即收模板清單同新片通知。Leave your email for the free template list and new-video notices.