如何使用 Claude API 金鑰：2025 年完整指南

\n\n## 前言

Claude 是 Anthropic 開發的強大 AI 助手，能夠執行各種任務，從生成創意內容到提供詳細的解釋。 若要以程式設計方式存取 Claude 的功能，您需要 API 金鑰。 本指南將引導您完成取得和使用 Claude API 金鑰的過程，並提供清晰、可行的步驟。

本指南假設您對程式設計概念有基本的了解，並且熟悉 API 的使用。 不需要先前的 Claude 使用經驗。 在本教學課程結束時，您將能夠使用 Claude API 進行身份驗證並發出您的第一個 API 呼叫。

先決條件

在開始之前，請確保您具備以下條件：

• Anthropic 帳戶： 您需要一個 Anthropic 帳戶才能存取他們的 API。 請前往 Anthropic 網站並註冊帳戶。
• API 金鑰： 您需要從 Anthropic 取得 API 金鑰。 此金鑰對於驗證您對 Claude API 的請求至關重要。
• 程式設計環境： 選擇一種程式語言（例如，Python、Node.js）並設定您的開發環境。 本指南主要使用 Python 作為範例。
• 套件管理器： 確保您已安裝套件管理器（例如，Python 的 pip，Node.js 的 npm）。
• 基本程式設計知識： 對程式設計概念（例如，變數、函數和發出 HTTP 請求）有基本的了解是必不可少的。

步驟 1：註冊 Anthropic 帳戶

如果您還沒有 Anthropic 帳戶，則需要建立一個。

1. 造訪 Anthropic 網站： 前往 Anthropic 官方網站 (anthropic.com)。
2. 註冊： 尋找「註冊」或「開始使用」按鈕。 確切的措辭可能會有所不同。
3. 提供資訊： 填寫所需資訊，例如您的姓名、電子郵件地址和密碼。
4. 驗證您的電子郵件： 檢查您的電子郵件收件匣中是否有來自 Anthropic 的驗證電子郵件。 按一下驗證連結以確認您的帳戶。
5. 完成個人資料（如果需要）： 某些平台可能要求您在驗證電子郵件後完成您的個人資料資訊。

步驟 2：取得您的 Claude API 金鑰

擁有 Anthropic 帳戶後，您可以取得您的 API 金鑰。

1. 登入： 在 Anthropic 網站上登入您的 Anthropic 帳戶。
2. 導覽至 API 設定： 尋找與「API 金鑰」、「開發人員」或「帳戶設定」相關的區段。 位置可能會因 Anthropic 網站佈局而異。
3. 產生 API 金鑰： 按一下以產生新 API 金鑰的選項。 您可能需要為金鑰提供名稱或描述。
4. 複製並安全地儲存： 產生金鑰後，將其複製到安全的地方。 這至關重要，因為關閉頁面後您將無法再次看到金鑰。 將其安全地儲存起來，例如在密碼管理器中，並避免將其提交到像 Git 這樣的版本控制系統。

步驟 3：設定您的程式設計環境

現在，設定您的程式設計環境以使用 Claude API。 我們將在本範例中使用 Python。

1. 安裝 Python： 如果您沒有安裝 Python，請從 Python 官方網站 (python.org) 下載並安裝最新版本。

2. 安裝 Anthropic Python 函式庫： 開啟您的終端機或命令提示字元，並使用 pip 安裝 Anthropic Python 函式庫：

   pip install anthropic
   

   此命令會下載並安裝與 Claude API 互動所需的 Python 函式庫。

3. 驗證安裝： 若要驗證函式庫是否已正確安裝，請在您的終端機中執行以下命令：

   pip show anthropic
   

   這應顯示有關已安裝的 Anthropic 函式庫的資訊，包括其版本和位置。

步驟 4：使用 Claude API 進行身份驗證

在使用 Claude API 之前，您需要使用您的 API 金鑰驗證您的請求。

1. 匯入 Anthropic 函式庫： 在您的 Python 腳本中，匯入 Anthropic 函式庫：

   import anthropic
   

2. 設定 API 金鑰： 設定 ANTHROPIC_API_KEY 環境變數或在建立用戶端時直接傳遞 API 金鑰。

   選項 1：使用環境變數（推薦）：

   在您的作業系統中設定 ANTHROPIC_API_KEY 環境變數。 這可防止您在腳本中硬式編碼金鑰。

   • Linux/macOS：

     export ANTHROPIC_API_KEY="YOUR_API_KEY"
     

   • Windows：

     set ANTHROPIC_API_KEY=YOUR_API_KEY
     

   將 YOUR_API_KEY 替換為您從 Anthropic 取得的實際 API 金鑰。

   選項 2：直接傳遞 API 金鑰（安全性較低）：

   您可以在建立 Anthropic 用戶端時直接傳遞 API 金鑰，但這種做法安全性較低，不建議用於生產環境。

   client = anthropic.Anthropic(api_key="YOUR_API_KEY")
   

   將 YOUR_API_KEY 替換為您的實際 API 金鑰。

3. 建立 Anthropic 用戶端： 建立 Anthropic 類別的實例以與 API 互動：

   client = anthropic.Anthropic() # 假設已設定 ANTHROPIC_API_KEY
   

   如果您使用環境變數方法，用戶端將自動從環境中取得 API 金鑰。

步驟 5：發出您的第一個 API 呼叫

現在您已通過身份驗證，您可以向 Claude API 發出您的第一個 API 呼叫。 我們將使用 messages.create 端點向 Claude 發送訊息並接收回應。

1. 準備您的提示： 建立一個提示以發送給 Claude。 提示應清晰簡潔，告訴 Claude 您希望它做什麼。

   prompt = "Write a short poem about the ocean."
   

2. 呼叫 messages.create 端點： 使用 messages.create 方法將您的提示發送給 Claude 並接收回應。

   message = client.messages.create(
       model="claude-3-opus-20240229", # Replace with your desired model
       max_tokens=1024,
       messages=[{"role": "user", "content": prompt}],
   )
   

   • model：指定您要使用的 Claude 模型。 請查看 Anthropic 文件以取得最新的可用模型。
   • max_tokens：指定產生回應中的最大 token 數量。
   • messages：代表對話歷史記錄的訊息清單。 每個訊息都有一個 role（「user」或「assistant」）和 content。

3. 列印回應： 列印回應的內容以查看 Claude 產生的內容。

   print(message.content[0].text)
   

   這將列印由 Claude 產生的詩。

步驟 6：完整範例程式碼

以下是呼叫 Claude API 的完整 Python 程式碼：