发起请求

一旦您了解了基本设置和结构，向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个令牌后停止。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

这会为您提供简洁、可读的输出，例如："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之间更复杂的交互了。