只想與 Claude 聊天？請訪問 claude.ai！

想直接深入了解我們的 API？請跳轉到我們的 API 參考文檔以獲取更多詳細信息。

讓我們快速幫助您開始使用 Claude！在本指南中，我們將引導您完成設置環境、安裝必要的庫以及向 Claude 發送第一個 API 請求的過程。讓我們開始吧！

請注意，雖然本指南使用我們的 Python SDK，但我們也維護 TypeScript SDK 並支持直接的 HTTP 集成。有關詳細信息，請參閱我們的客戶端 SDK 和 API 參考文檔。

​
先決條件

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

  • 具有 API 訪問權限的帳戶（請參閱我們的獲取 Claude 訪問權限指南）
  • API 密鑰（可通過您的帳戶設置獲得）
  • 在您的計算機上安裝了 Python 3.7.1 或更新版本

​
步驟 1：設置您的環境

複製我們的 quickstart Google Colab notebook，無需設置環境即可立即開始！

首先，確保您已安裝 Python。打開終端（在 macOS 上）或命令提示符（在 Windows 上）並輸入：

Shell
python --version

如果您看到類似 “Python 3.12.2” 的版本號，則說明一切就緒。如果沒有，請訪問 Python 官方網站並下載最新版本。

​
（可選）創建虛擬環境

雖然不是強制性的，但建議為您的 Claude 項目創建虛擬環境。這有助於保持依賴項的組織性，並防止與其他項目發生衝突。要創建虛擬環境，請運行：

Shell
python -m venv claude-env

然後，激活它：

  • 在 macOS 或 Linux 上：source claude-env/bin/activate
  • 在 Windows 上：claude-env\Scripts\activate

​
步驟 2：安裝 Anthropic Python SDK

設置好環境後，就可以安裝 Claude Python 庫了。只需運行：

Shell
pip install anthropic

此命令將安裝最新版本的庫以及任何必要的依賴項。

​
步驟 3：（可選）設置您的 API 密鑰

要使用 Claude，您需要提供 API 密鑰。您可以通過設置環境變量，使 API 密鑰可用於所有 Claude 項目。方法如下：

  • 在 macOS 或 Linux 上：
    1. 打開終端並輸入：nano ~/.bash_profile（如果您使用較新版本的 macOS，則輸入 nano ~/.zshrc）
    2. 將此行添加到文件中，將 your-api-key-here 替換為您的實際 API 密鑰：export ANTHROPIC_API_KEY='your-api-key-here'
    3. 保存文件並退出編輯器（按 Ctrl+O，然後按 Enter，再按 Ctrl+X）
    4. 通過運行以下命令加載更新後的配置文件：source ~/.bash_profile（或 source ~/.zshrc）
  • 在 Windows 上：
    1. 打開命令提示符並輸入：setx ANTHROPIC_API_KEY "your-api-key-here"，將 your-api-key-here 替換為您的實際 API 密鑰
    2. 要使此更改永久生效，請按照以下步驟操作：
      • 右鍵單擊”此電腦”或”我的電腦”，然後選擇”屬性”
      • 單擊”高級系統設置”
      • 單擊”環境變量”按鈕
      • 在”系統變量”部分中，單擊”新建…”，然後輸入 ANTHROPIC_API_KEY 作為變量名稱，輸入您的 API 密鑰作為變量值

​
步驟 4：發送您的第一個 API 請求

您快要完成了！讓我們向 Claude 發送您的第一個 API 請求。創建一個新的 Python 文件（例如 claude_test.py），並添加以下代碼：

Python
import anthropic

client = anthropic.Anthropic(
    # 默認為 os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="只用尤達語回答。",
    messages=[
        {"role": "user", "content": "你今天好嗎？"}
    ]
)

print(message.content)

讓我們分析一下這裡發生了什麼：

  • 我們導入了 anthropic 庫，它提供了一種與 Claude API 交互的便捷方式。
  • 我們創建了一個 Anthropic 客戶端實例，傳入我們的 API 密鑰（如果您設置了環境變量，則可以省略此步驟）。
  • 我們調用 messages.create() 方法向 Claude 發送消息。我們指定要使用的模型（claude-3-opus-20240229）、響應中的最大令牌數（max_tokens=1000）、溫度（控制輸出的隨機性，temperature=0.0 表示最小隨機性）以及系統消息（設置對話的上下文）。
  • 最後，我們打印 Claude 的響應。

要運行代碼，只需在終端或命令提示符中輸入 python claude_test.py。您應該會看到 Claude 的一個類似諺語的響應！

有關更多示例 API 調用結構，請訪問 Messages API 示例。有關 API 參數的更多信息，請參閱 Messages API 參考。

​
後續步驟

恭喜您成功向 Claude 發送了第一個 API 請求！以下是一些後續步驟，以繼續您的旅程。

​
API 資源

深入我們的 API 文檔，了解有關可用端點和參數的更多詳細信息。

查看我們的客戶端 SDK，獲取一組工具，使您更輕鬆地使用 Claude 構建應用程序並將其集成到您的應用程序中。

​
Anthropic 食譜

Anthropic 食譜包含一組以 Jupyter notebook 形式呈現的食譜。這些 notebook 提供了可複製的代碼，演示了如何在更高級的場景中以巧妙有效的方式使用 Claude，例如上傳 PDF、工具使用和函數調用、嵌入等。

​
其他資源

  • 訪問我們的遷移指南，了解如何將您的用例過渡到 Claude。
  • 探索術語表，熟悉 AI、LLM 和 Claude 生態系統中使用的術語。
  • 加入我們的開發者 Discord 服務器，與其他開發者聯繫，提出問題並分享您的項目。
  • 訪問提示庫，獲取各種任務的靈感和現成的提示，或通過查看提示簡介來涉足提示工程。

我們期待看到您使用 Claude 創造的成果。祝編程愉快！

歡迎來到 Claude獲取 Claude 的使用權限