极客前沿

Claude API 入门:安装、配置、第一次调用

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

从零开始,教你安装 anthropic 包、获取 API 密钥,并在 Python 中成功调用 Claude 模型。

准备工作

在开始之前,请确保你满足以下条件:

Tutorial Image
  • 会基本的 Python 操作,比如运行脚本、使用终端。
  • Python 版本 ≥ 3.9(在终端运行 python --version 查看版本)。
  • 拥有一个 Anthropic 账户(这是 Claude 背后的公司)。

如果你没有账户,去 Claude Console 注册,并充值至少 5 美元才能使用 API。

Tutorial Image

获取 API 密钥

API 密钥是你调用 Claude 的“密码”,必须妥善保管。

Tutorial Image
  1. 登录 Claude Console,进入 API Keys 页面。
  2. 点击 Create Key,给你的密钥起个名字(比如 my-claude-key),然后复制它——关闭对话框后就再也看不到了。
  3. 不要把密钥直接写在代码里! 把它设为环境变量。在终端执行:
    • Windows(命令提示符):set ANTHROPIC_API_KEY=你的密钥
    • macOS / Linux:export ANTHROPIC_API_KEY=你的密钥

设置好后,Python 的 anthropic 包会自动读取这个环境变量,你无需在代码中显式写出密钥。

Tutorial Image

安装 anthropic 包并调用 Claude

首先,创建一个虚拟环境(推荐,避免包冲突):

  • 在终端运行 python -m venv venv
  • 激活虚拟环境:Windows 执行 venv\Scripts\activate,macOS/Linux 执行 source venv/bin/activate

然后安装 anthropic 包:

  • pip install anthropic

现在,新建一个 Python 文件(比如 first_call.py),写入以下代码:

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=100,
    messages=[
        {"role": "user", "content": "用一句话介绍自己"}
    ]
)

print(response.content[0].text)

运行脚本:python first_call.py。如果一切正常,你会在终端看到 Claude 的回复。恭喜,你已经成功调用了 Claude API!

常见问题

  • 密钥错误:检查环境变量是否正确设置,或重启终端后重试。
  • 网络问题:确保你的网络可以访问 api.anthropic.com。
  • 费用提示:API 调用按 token 计费,记得在控制台关注用量。

内容来源

Real Python

发布时间

2026-05-21 01:30

返回 AI技术