极客前沿

Claude API 入门:Python 安装与第一次调用

2026-05-21 01:30
Real Python
查看原文

手把手教你安装 Anthropic SDK、发送第一条提示、获取 JSON 输出,零基础也能快速上手。

准备环境

在开始之前,你需要确保电脑上已经安装了 Python(一种编程语言,用于编写和运行代码)。如果还没有,请前往 python.org 下载并安装。建议选择 Python 3.8 或更高版本。

另外,你需要一个 Claude API 密钥(一串用来验证身份的密码)。访问 Anthropic 控制台,注册账号后,在“API Keys”页面生成一个新密钥,并复制保存好。

安装 Anthropic SDK

SDK(软件开发工具包)是一组工具,让 Python 能轻松与 Claude 通信。打开终端(Mac 的“终端”或 Windows 的“命令提示符”),运行以下命令:

  • pip install anthropic(如果提示 pip 找不到,试试 python -m pip install anthropic

等待安装完成。如果遇到网络问题,可以换用国内镜像源,例如:pip install anthropic -i https://pypi.tuna.tsinghua.edu.cn/simple

Tutorial Image

发送第一条提示

创建一个新的 Python 文件(比如 claude_test.py),写入以下代码:

  1. 导入库:from anthropic import Anthropic
  2. 初始化客户端:client = Anthropic(api_key="你的密钥")(把“你的密钥”替换成刚才复制的真实密钥)
  3. 发送消息:
    response = client.messages.create(
        model="claude-3-haiku-20240307",
        max_tokens=100,
        messages=[{"role": "user", "content": "你好,请用中文回答:什么是AI?"}]
    )
  4. 打印回复:print(response.content[0].text)

运行文件:在终端执行 python claude_test.py。如果一切顺利,你会看到 Claude 的回答。

常见坑:密钥不要直接写在代码里,建议使用环境变量(比如 os.environ["ANTHROPIC_API_KEY"]),防止泄露。

获取结构化 JSON 输出

Claude 可以返回格式化的 JSON 数据。例如,想让 Claude 提取一段文字中的日期和事件:

Tutorial Image
  • messages 中添加 "system": "请以JSON格式输出,包含字段:date, event"
  • 设置 response_format{"type": "json_object"}

示例代码片段:

response = client.messages.create(
    model="claude-3-haiku-20240307",
    max_tokens=200,
    system="请以JSON格式输出,包含字段:date, event",
    messages=[{"role": "user", "content": "2023年5月,OpenAI发布了GPT-4。"}]
)

输出会是类似 {"date": "2023年5月", "event": "OpenAI发布了GPT-4"} 的 JSON 字符串,方便程序进一步处理。

下一步可以做什么

现在你已经能调用 Claude API 了!可以尝试:

  • 调整 max_tokens(最大输出字数)和 temperature(创造力,0-1之间,越高越随机)
  • 使用 Pydantic(一个数据校验库)来定义更复杂的 JSON 输出结构
  • 将 Claude 集成到你的聊天机器人、内容生成器或数据分析工具中

内容来源

Real Python

发布时间

2026-05-21 01:30

返回 AI技术