發出請求

一旦您了解基本設定和結構，向 Anthropic API 發出您的第一個請求就會變得很簡單。本指南將引導您完成使用 Python 讓 Claude 回應您的提示所需的基本步驟。

設定您的環境

在進行任何 API 呼叫之前，您需要安裝所需的套件並安全地設定您的 API 金鑰。

首先，在您的 Jupyter notebook 中安裝必要的相依套件：

%pip install "anthropic<1" python-dotenv

接下來，在與您的 notebook 相同的目錄中建立一個 .env 檔案，以安全地儲存您的 API 金鑰：

ANTHROPIC_API_KEY="your-api-key-here"

這種方法可以讓您的 API 金鑰不出現在程式碼中，並防止意外將其提交到版本控制系統。請務必將 .env 加入您的 .gitignore 檔案中。

載入環境變數並建立您的 API 客戶端：

from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-haiku-4-5"

Create 函式

發出 API 請求的核心是 client.messages.create() 函式。此函式需要三個關鍵參數：



• model - 您想要使用的 Claude 模型名稱
• max_tokens - 回應長度的安全上限（並非目標值）
• messages - 您傳送給 Claude 的對話歷史記錄

max_tokens 參數作為一種安全機制。如果您將其設定為 1000，即使 Claude 還有更多內容要說，它也會在生成 1000 個 token 後停止。Claude 不會試圖達到這個上限——它只會寫出它認為合適的內容，並在達到上限時停止。

了解訊息

訊息代表您與 Claude 之間的對話，類似於聊天應用程式。訊息有兩種類型：



• 使用者訊息 - 您想要傳送給 Claude 的內容（由人類撰寫）
• 助理訊息 - Claude 生成的回應

每則訊息都是一個字典，包含 role（「user」或「assistant」）和 content（實際文字內容）。

發出您的第一個請求

以下是向 Claude 發出請求的完整範例：

message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

當您執行此程式碼時，Claude 會處理您的請求，並回傳一個包含生成文字以及該請求相關中繼資料的回應物件。

擷取回應

回應物件包含大量資訊，但您通常只需要生成的文字。使用以下方式存取它：

message.content[0].text

這會為您提供乾淨、易讀的輸出，例如：「量子運算是一種運用量子力學原理（如疊加和糾纏）來處理資訊的運算類型，使用量子位元（qubits），有可能以指數級的速度比傳統電腦更快地解決某些複雜問題。」

有了這些基礎知識，您就可以開始嘗試不同的提示，並與 Claude 建立更複雜的互動。