Claude API Python 教學:安裝 SDK、第一次呼叫、多輪對話與串流(2026 年 11 月)

Claude API Python 教學:安裝 SDK、第一次呼叫、多輪對話與串流(2026 年 11 月)
Claude API Python 教學:安裝 SDK、第一次呼叫、多輪對話與串流(2026 年 11 月)
帶你打造網路被動收入

Claude API Python 怎麼寫?官方提供名為 anthropic 的 Python 套件,安裝後建立一個 Anthropic() 用戶端,呼叫 client.messages.create() 就能送出請求,API Key 則由環境變數 ANTHROPIC_API_KEY 自動讀取。這篇教學依照官方快速入門,從建立專案、第一次呼叫,一路延伸到多輪對話、system 提示與串流輸出。所有程式碼都改寫自官方文件的範例結構,模型 ID 取自 2026 年 11 月查閱的官方模型總覽,之後可能更新,請以官方文件為準。還沒有 Key 的讀者,請先看Claude API Key 怎麼取得。

快速答案:pip install anthropic 安裝套件,設定環境變數 ANTHROPIC_API_KEY,用 client.messages.create(model=..., max_tokens=..., messages=[...]) 送出請求,再從 message.content 裡取出 type 為 text 的區塊。

建立專案與第一次呼叫

官方快速入門建議在虛擬環境裡安裝:

mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic

Windows 的啟用虛擬環境指令不同,官方快速入門只列出 macOS 與 Linux 的寫法。接著設定 Key(官方範例用 export),然後建立 quickstart.py:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "請用繁體中文介紹 Claude API"}
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

官方範例使用的是 claude-opus-5-5;這裡改用 claude-sonnet-5-5,兩者都是官方模型總覽列出的 API ID,Sonnet 5.5 的單價較低(輸入 2 美元、輸出 10 美元,每百萬 token)。費用試算見Claude API 價格怎麼算。執行 python quickstart.py 即可看到回應。

為什麼要用迴圈取 type == "text"?因為官方說明回應的 content 是區塊陣列,除了文字,之後使用工具或思考時也會出現其他類型的區塊。

筆電螢幕上的程式碼與木桌
圖片:Daniil Komov/Pexels

多輪對話、system 提示與 request id

Messages API 是無狀態的,多輪對話要自己保存歷史,每次送出完整的 messages:

history = [{"role": "user", "content": "Hello, Claude"}]
reply = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1000,
    system="你是一位說明清楚的技術講師,請用繁體中文回答。",
    messages=history,
)
history.append({"role": "assistant", "content": reply.content})
history.append({"role": "user", "content": "Can you describe LLMs to me?"})
reply2 = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1000,
    system="你是一位說明清楚的技術講師,請用繁體中文回答。",
    messages=history,
)
print(reply2._request_id)

重點有三個:

  1. system 提示:官方說明從一開始就適用的指示,放在頂層的 system 欄位。
  2. 最後一筆必須是 user:Claude 4.6 以後的模型不支援預填 assistant 回應,否則回傳 400。
  3. request id:官方 Python SDK 在回應物件上提供 _request_id 屬性,聯絡支援時可附上。

另外,Claude 4.7 以後的模型不接受非預設的 temperature、top_p、top_k,不要放進請求。更完整的請求結構可以對照Claude API 教學的 curl 版本。

免費領取《從零到百萬:新手快速提升行銷收入指南》

學會如何建立一套能 24 小時自動培養名單、自動化成交系統

我要自動化成交客戶的秘密

串流輸出與錯誤處理

輸出很長的時候,官方建議使用串流,以免連線在等待期間被網路中斷。官方範例用 client.messages.stream():

with client.messages.stream(
    max_tokens=4000,
    messages=[{"role": "user", "content": "請寫一份詳細的分析"}],
    model="claude-sonnet-5-5",
) as stream:
    message = stream.get_final_message()

print(next(block.text for block in message.content if block.type == "text"))

官方也說明,SDK 會驗證非串流請求預期不會超過 10 分鐘,因此預期很長的輸出時,改用串流或批次 API 比較安全。

錯誤方面,官方 SDK 會把 HTTP 錯誤轉成具型別的例外,例如 404 對應 anthropic.NotFoundError,並建議捕捉具體的類別而不是比對錯誤訊息字串。SDK 預設會自動重試連線錯誤、429 與 5xx 兩次,並遵守 retry-after。重試次數可以用 max_retries 設定。

開發者在鍵盤上輸入程式
圖片:cottonbro studio/Pexels

做完 Python 版之後,如果你偏好 JavaScript,可看Claude API Node.js 教學;想讓 Claude 呼叫你寫的函式,可看Claude API Tool Use。

官方沒有說明的部分

  1. 快速入門沒有說明支援的 Python 最低版本,請查官方 SDK 頁面。
  2. 快速入門沒有提供 Windows 虛擬環境啟用指令。
  3. 中文輸出的品質與提示寫法,官方沒有專屬指南。
  4. reply.content 直接放回歷史的做法來自官方工具範例的寫法;是否需要其他處理(例如含思考區塊的回應),請依官方 Messages API 與思考文件。

結論:先跑通,再加功能

先讓第一個範例跑通,確認 Key、模型 ID 與網路都沒問題,再逐步加入多輪對話、system 與串流。需要控制成本時,記得在 Console 設定花費上限。API 全貌可回看Claude API 是什麼。

常見問題 FAQ

一定要用環境變數嗎?

官方範例使用環境變數,SDK 會自動讀取 ANTHROPIC_API_KEY,這也避免把 Key 寫進程式碼。

content 為什麼是陣列?

回應可能包含多種區塊,所以官方範例用迴圈挑出 type 為 text 的區塊。

模型要選哪個?

官方快速入門範例用 Opus 5.5;成本敏感時可評估 Sonnet 5.5 或 Haiku 5.5,依任務挑選。

遇到 429 怎麼辦?

SDK 預設會重試兩次;若持續失敗,檢查速率限制與花費上限,有 retry-after 就等待該秒數。


參考資料

想建立 24/7 自動成交的課程獲利系統嗎?

如果你想建立的不只是電子報,而是一套真正能自動幫你成交的內容變現系統,那你可以進一步了解:

《百萬課程獲利藍圖:打造 24/7 幫你自動賣課的印鈔系統》

這套系統會完整分享:

  • 如何建立高轉換Email名單
  • 如何設計Lead Magnet
  • 如何打造Email自動化流程
  • 如何透過內容建立穩定現金流
  • 如何讓線上課程24小時自動成交

即使沒有大量粉絲,也能透過內容、Email與自動化漏斗,慢慢建立穩定的獲利模式。

了解《百萬課程獲利藍圖》

免費建立被動收入教學

Claude API Python 教學:安裝 SDK、第一次呼叫、多輪對話與串流(2026 年 11 月)
免費教你開始建立被動收入

發佈留言