Python开发者指南：快速集成Anthropic Claude API

你希望自己的Python脚本能够进行思考和推理吗？本教程将指导Python开发者如何将代码与Anthropic的AI模型Claude连接，从而让你的项目具备阅读、理解和响应的能力。

准备工作

在开始之前，有两点需要了解：

• API调用会产生费用。尽管费用不高（5美元通常可供数周正常使用），但这与免费的Claude.ai聊天界面不同。你需要前往 console.anthropic.com 添加积分。
• 你的Python版本需为3.9或更高。可通过以下命令检查：

  python --version

  如果版本低于3.9，请访问 python.org 更新。在Windows上安装时，请务必勾选“Add Python to PATH”，否则可能导致后续配置问题。

环境搭建

按照以下步骤创建项目文件夹、设置虚拟环境并安装必要的SDK：

mkdir claude-project
cd claude-project
python -m venv venv

接下来，激活你的虚拟环境：

• Mac/Linux:

  source venv/bin/activate

• Windows:

  venv\Scripts\activate

激活成功后，你的终端提示符前会显示(venv)。在虚拟环境激活状态下安装软件包，以确保它们被正确隔离：

pip install anthropic python-dotenv

获取API密钥

访问 console.anthropic.com 创建账户，并在“API Keys”部分生成一个新密钥。

将密钥存储在项目文件夹中的.env文件里：

ANTHROPIC_API_KEY=your-key-here

为了安全起见，务必将.env文件添加到.gitignore中，防止密钥泄露至公共仓库：

echo .env > .gitignore

这是一个非常关键的安全措施。公开的API密钥可能在数小时内被发现、滥用并产生高额费用。

首次API调用

以下是如何通过Python与Claude进行交互的示例代码：

from dotenv import load_dotenv
from anthropic import Anthropic

load_dotenv()
client = Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "What is a REST API?"
        }
    ]
)

print(message.content[0].text)

运行这段代码，Claude的回答将显示在你的终端中。

关于此次API调用，有三个关键点需要理解：

• model：指定你使用的Claude模型版本。claude-sonnet-4-6是大多数场景下的默认选择，它兼具速度与能力。
• max_tokens：设定Claude响应的最大长度。如果设置过低，响应可能会在语句中途被截断。1024是一个安全的起始值。
• messages：这是一个对话轮次的列表。每个轮次都包含"role"（角色，如"user"或"assistant"）和"content"（消息内容）。