精華筆記

新手指南 ／ Claude API 開發實戰

Claude API 開發實戰

Claude API 開發實戰:共 8 課,依序學完就能上手。

適合誰:適合有 JS 或 Python 基礎,想從第一個 API call 做到可用服務的人。

  1. 01
    第一支程式:呼叫 Claude API

    第一支程式:呼叫 Claude API

    訂閱 Claude.ai 和 Claude API 是兩件事。這堂帶你在 Console 拿 API Key、用 .env 保存金鑰、裝好 Python 與 JavaScript SDK,寫出第一支能跑的 messages 程式,讀懂回應物件,並排解 401、429、SDK 版本三個新手常踩的坑。

    →
  2. 02
    模型與計價:選對模型省十倍

    模型與計價:選對模型省十倍

    多數人第一次用 Claude API 就直接選最強的模型,帳單來了才嚇到。這堂課帶你看清楚 Haiku、Sonnet、Opus 三個等級的能力與價格差距,學會用 token 算真實成本,建立「什麼任務選什麼模型」的決策表,並設好用量上限不爆帳。

    →
  3. 03
    System Prompt 與多輪對話

    System Prompt 與多輪對話

    搞清楚 system 與 user 的角色差異,掌握 prompt 工程三板斧(角色、邊界、格式),理解 Messages API 的無狀態本質與 messages 陣列組裝方式,學會對話歷史裁剪策略,調好 temperature 參數,最後從頭寫一支有人設的 CLI 對話機器人。

    →
  4. 04
    結構化輸出:保證拿到合法 JSON

    結構化輸出:保證拿到合法 JSON

    在 prompt 裡叫 Claude 輸出 JSON,常拿到被 markdown 包裹、多了前言、或逗號出錯的字串,讓 json.loads() 直接爆掉。這堂課教你用 Structured Outputs,透過 output_config.format 傳入 JSON Schema,在 token 層級保證輸出 100% 合法 JSON,並整合 Python Pydantic 與 TypeScript Zod,完成一個文本抽取 API。

    →
  5. 05
    Tool Use:讓 Claude 呼叫你的函式

    Tool Use:讓 Claude 呼叫你的函式

    Claude 天生只會生成文字,拿到「現在幾度」「幫我查資料庫」就卡住了。這堂課教你用 Tool Use 把自己寫的函式接進 Claude:定義工具的三個核心欄位、讀懂 tool use 完整迴圈、同時給多個工具讓模型自己選,以及實作天氣+計算機雙工具 agent 雛形,讓 Claude 真正能採取行動。

    →
  6. 06
    Streaming 與多模態輸入

    Streaming 與多模態輸入

    這堂課帶你搞定 Claude API 兩個實用技能:Streaming 讓回應逐字浮現、消除等待感;多模態輸入讓你把圖片與 PDF 直接丟進 messages 給 Claude 判讀。內容涵蓋 SSE 串流原理、Python 與 JavaScript 的串流寫法、圖片 base64 與 URL 兩種傳法、PDF 文件輸入,最後實作收據辨識加串流輸出的完整小工具。

    →
  7. 07
    Prompt Caching 與 Batch:成本砍半

    Prompt Caching 與 Batch:成本砍半

    帳單暴衝最怕兩件事:同一份長文件反覆送、大量任務全部即時跑。這堂課教你 Prompt Caching 省 90% 輸入成本,Batch API 再打五折,組合可壓到基準成本的 5%。含 Python/JS 完整範例、usage 欄位解讀與帳單對比。

    →
  8. 08
    綜合實戰:客服 API 服務上線

    綜合實戰:客服 API 服務上線

    前七課學的所有技術在這堂課整合成一個真正可以上線的客服 API 服務。用 FastAPI(附 Express 版)搭建完整的生產 endpoint:System Prompt 注入、FAQ 快取、結構化輸出、Streaming 全到位;再加上指數退避重試、超時防護、金鑰輪替、月費估算,以及六個真實踩坑紀錄。讀完能直接把架構搬進自己的產品。

    →