加载中
加载中

一旦您理解了基本设置和结构,向 Anthropic API 发起您的第一个请求就会变得非常直接。本指南将带您了解使用 Python 让 Claude 响应您的提示所需的基本步骤。

设置您的环境

在进行任何 API 调用之前,您需要安装所需的软件包,并安全地配置您的 API 密钥。

首先,在您的 Jupyter notebook 中安装必要的依赖项:

bash
%pip install "anthropic<1" python-dotenv

接下来,在与您的 notebook 相同的目录中创建一个 .env 文件,以安全地存储您的 API 密钥:

bash
ANTHROPIC_API_KEY="your-api-key-here"

这种方法可以使您的 API 密钥不出现在代码中,并防止意外将其提交到版本控制系统。请务必将 .env 添加到您的 .gitignore 文件中。

加载环境变量并创建您的 API 客户端:

python
from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

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

在整个课程中请保留此模型和软件包版本。较新的版本会拒绝后续课程中讲授的某些设置,例如 temperature 和预填充的助手消息。

Create 函数

发起 API 请求的核心是 client.messages.create() 函数。此函数需要三个关键参数:

client.messages.create 调用及标注其三个参数的说明标签,下方列出了 model、max_tokens 和 messages。

  • model(模型) - 您想要使用的 Claude 模型的名称
  • max_tokens(最大令牌数) - 对响应长度的安全限制(而非目标值)
  • messages(消息) - 您发送给 Claude 的对话历史

max_tokens 参数充当一种安全机制。如果您将其设置为 1000,即使 Claude 还有更多内容要说,它也会在生成 1000 个令牌后停止。Claude 不会试图达到这个限制——它只是写出它认为合适的内容,如果达到最大值就停止。

理解消息

消息代表您与 Claude 之间的对话,类似于一个聊天应用程序。消息有两种类型:

聊天窗口中,用户消息问"什么是量子计算?",助手消息是对此进行定义的 AI 回复。

  • 用户消息 - 您想要发送给 Claude 的内容(由人类撰写)
  • 助手消息 - Claude 生成的响应

每条消息都是一个字典,包含一个 role("user" 或 "assistant")和 content(实际文本)。

发起您的第一个请求

以下是向 Claude 发起请求的完整示例:

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

当您运行此代码时,Claude 将处理您的请求,并返回一个响应对象,其中包含生成的文本以及有关该请求的元数据。

提取响应

响应对象包含大量信息,但您通常只需要生成的文本。可以这样访问:

python
message.content[0].text

这会为您提供干净、易读的输出,例如:"Quantum computing is a type of computation that leverages quantum mechanics principles like superposition and entanglement to process information using quantum bits (qubits), potentially solving certain complex problems exponentially faster than classical computers."

有了这些基础知识,您就可以开始尝试不同的提示,并构建与 Claude 之间更复杂的交互了。