Claude API 入门:安装、配置、第一次调用
从零开始,教你安装 anthropic 包、获取 API 密钥,并在 Python 中成功调用 Claude 模型。
准备工作
在开始之前,请确保你满足以下条件:
- 会基本的 Python 操作,比如运行脚本、使用终端。
- Python 版本 ≥ 3.9(在终端运行 python --version 查看版本)。
- 拥有一个 Anthropic 账户(这是 Claude 背后的公司)。
如果你没有账户,去 Claude Console 注册,并充值至少 5 美元才能使用 API。
获取 API 密钥
API 密钥是你调用 Claude 的“密码”,必须妥善保管。
- 登录 Claude Console,进入 API Keys 页面。
- 点击 Create Key,给你的密钥起个名字(比如
my-claude-key),然后复制它——关闭对话框后就再也看不到了。 - 不要把密钥直接写在代码里! 把它设为环境变量。在终端执行:
- Windows(命令提示符):
set ANTHROPIC_API_KEY=你的密钥 - macOS / Linux:
export ANTHROPIC_API_KEY=你的密钥
- Windows(命令提示符):
设置好后,Python 的 anthropic 包会自动读取这个环境变量,你无需在代码中显式写出密钥。
安装 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