一旦您理解了基本设置和结构,向 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"在整个课程中请保留此模型和软件包版本。较新的版本会拒绝后续课程中讲授的某些设置,例如 temperature 和预填充的助手消息。
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 之间更复杂的交互了。