
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 anthropicWindows 的啟用虛擬環境指令不同,官方快速入門只列出 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 是區塊陣列,除了文字,之後使用工具或思考時也會出現其他類型的區塊。

多輪對話、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)重點有三個:
- system 提示:官方說明從一開始就適用的指示,放在頂層的
system欄位。 - 最後一筆必須是 user:Claude 4.6 以後的模型不支援預填 assistant 回應,否則回傳 400。
- 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 設定。

做完 Python 版之後,如果你偏好 JavaScript,可看Claude API Node.js 教學;想讓 Claude 呼叫你寫的函式,可看Claude API Tool Use。
官方沒有說明的部分
- 快速入門沒有說明支援的 Python 最低版本,請查官方 SDK 頁面。
- 快速入門沒有提供 Windows 虛擬環境啟用指令。
- 中文輸出的品質與提示寫法,官方沒有專屬指南。
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 就等待該秒數。
參考資料
- Claude 開發者文件:Get started
- Claude 開發者文件:Using the Messages API
- Claude 開發者文件:API errors
- Claude 開發者文件:Models overview
- 圖片來源:Daniil Komov、cottonbro studio(Pexels)
想建立 24/7 自動成交的課程獲利系統嗎?
如果你想建立的不只是電子報,而是一套真正能自動幫你成交的內容變現系統,那你可以進一步了解:
《百萬課程獲利藍圖:打造 24/7 幫你自動賣課的印鈔系統》
這套系統會完整分享:
- 如何建立高轉換Email名單
- 如何設計Lead Magnet
- 如何打造Email自動化流程
- 如何透過內容建立穩定現金流
- 如何讓線上課程24小時自動成交
即使沒有大量粉絲,也能透過內容、Email與自動化漏斗,慢慢建立穩定的獲利模式。

