课程目标 #
在第一课中，您将学习如何：
安装必要的软件包并使用 API 进行身份验证
向 Claude AI 助手发出第一个请求
安装 SDK #
在深入研究 SDK 之前，请确保您的系统上安装了 Python。
Claude Python SDK 需要 Python 3.7.1 或更高版本。
您可以通过在终端中运行以下命令来检查当前的 Python 版本：python –version
如果您没有安装 Python 或您的版本早于 3.7.1，请访问 Python 官方网站并按照您的操作系统的安装说明进行操作。
准备好 Python 后，您现在可以使用 pip 安装 Anthropic 包
# Use this command if installing the package from inside a notebook
%pip install anthropic
#Use this command to install the package from the command line
# pip install anthropic获取 API 密钥 #
要验证您对 Claude API 的请求，您需要一个 API 密钥。
请按照以下步骤获取您的 API 密钥：
- 1、如果您还没有，请访问 https://console.anthropic.com 注册一个 Anthropic 帐户
- 2、创建帐户并登录后，导航到 API 设置页面。您可以通过单击右上角的个人资料图标并从下拉菜单中选择“API 密钥”或导航到“设置”选项卡中的“API 密钥”菜单来找到此页面。
- 3、在 API 设置页面上，单击“创建密钥”按钮。将出现一个模式窗口，提示您为密钥指定一个描述性名称。选择一个反映您将使用该密钥的目的或项目的名称。您可以在帐户中创建任意数量的密钥（请注意，速率和消息限制适用于帐户级别，而不是 API 密钥级别）。
- 4、输入名称后，单击“创建”按钮。您的新 API 密钥将生成并显示在屏幕上。
请确保复制此密钥，因为一旦离开此页面，您将无法再次查看它。
请确保复制此密钥，因为一旦离开此页面，您将无法再次查看它。
请记住，您的 API 密钥是授予您 Anthropic 帐户访问权限的敏感信息。请将其视为密码，切勿公开分享或提交给 Git 等版本控制系统。
安全存储您的 API 密钥 #
虽然您可以直接在 Python 脚本中对 API 密钥进行硬编码，但通常认为最佳做法是将敏感信息（如 API 密钥）与代码库分开保存。一种常见方法是将 API 密钥存储在 .env 文件中，并使用 python-dotenv 包加载它。您可以按以下方式进行设置：
在与笔记本相同的目录中创建一个名为 .env 的新文件。
使用以下格式将您的 API 密钥添加到新创建的 .env 文件中：
ANTHROPIC_API_KEY=put-your-api-key-here
确保保存 .env 文件
通过在终端或笔记本中运行以下命令来安装 python-dotenv 包：
#To install the package from a notebook:
%pip install python-dotenv
#To install the package from your terminal:
# pip install python-dotenv我们现在可以使用 dotenv 模块中的 load_dotenv() 函数从 .env 文件加载 API 密钥，代码如下：
from dotenv import load_dotenv
import os
load_dotenv()
my_api_key = os.getenv("ANTHROPIC_API_KEY")使用客户端发出基本请求 #
安装 anthropic 包并加载 API 密钥后，您就可以开始向 Claude API 发出请求了。
第一步是创建一个客户端对象，它是与 API 交互的主要入口点。
from anthropic import Anthropic
client = Anthropic(
api_key=my_api_key
)请注意，anthropic SDK 会自动查找名为“ANTHROPIC_API_KEY”的环境变量，因此您实际上不必手动传递它.
现在我们已经实例化了客户端，是时候发出第一个请求了。
要向 Claude 发送消息并接收响应，我们将使用客户端对象的 messages.create() 方法。我们将在下一课中讨论具体参数和响应格式。现在，尝试运行以下代码，您应该会从 Claude 收到第一条消息！
our_first_message = client.messages.create(
model="claude-3-haiku-20240307",
max_tokens=1000,
messages=[
{"role": "user", "content": "你好！请给我写一首关于宠物鸡的俳句"}
]
)
print(our_first_message.content[0].text)
长着羽毛的朋友咯咯叫，
整天在泥土里抓挠，
忠诚的宠物鸡。练习 #
我们才刚刚开始，所以这个练习可能会让人感觉有点乏味。练习一些基础知识总是好的。
请执行以下操作：
- 1.创建一个新的笔记本或 Python 脚本。
- 2.导入适当的包
- 3.加载您的 Anthropic API 密钥
- 4.让 Claude 给您讲一个笑话，然后打印出结果（您可以复制/粘贴上面的代码并对其进行调整）