Claude API 允许你在自己的 Python 代码中直接调用 Claude 的强大模型（Opus 4.6、Sonnet 4.6 等）。本教程专为零基础新手设计，从安装到第一次成功调用，全程手把手，提供可直接复制运行的完整代码。
预计10分钟上手，所有示例基于 Anthropic 官方 Python SDK（2026年3月最新版本）。
一、准备工作（2分钟）
1. 确保已安装 Python 3.10 或更高版本（命令行输入 python --version 检查）。
2. 已申请好 Claude API Key（console.anthropic.com/settings/keys）。
二、安装 Claude Python SDK（30秒）
打开命令行（Windows 用 PowerShell，Mac/Linux 用 Terminal），运行：
pip install anthropic三、设置 API Key（推荐方式）
推荐使用环境变量（安全、不用写死在代码里）。
Mac / Linux：
export ANTHROPIC_API_KEY="sk-ant-你的完整Key粘贴在这里"Windows PowerShell：
$env:ANTHROPIC_API_KEY="sk-ant-你的完整Key粘贴在这里"以后每次打开新命令行只需运行一次即可。
四、最基础调用示例（单轮对话）
创建一个文件 claude_basic.py，复制以下完整代码：
import anthropic
# 自动读取环境变量中的 API Key
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-4-6", # 2026新手推荐模型：速度快 + 质量高
max_tokens=500, # 最大回复长度
temperature=0.7, # 创意度（0.0最稳定，1.0最有创意）
messages=[
{
"role": "user",
"content": "你好，我是第一次用Python调用Claude API的新手，请用中文简单介绍一下你自己！"
}
]
)
print(response.content[0].text)运行命令：
python claude_basic.py看到 Claude 的回复，就代表调用成功！
五、多轮对话完整示例（推荐新手练习）
文件 claude_chat.py：
import anthropic
client = anthropic.Anthropic()
# 模拟多轮对话历史
conversation = [
{"role": "user", "content": "你好，我叫小明，今年25岁，在学习Python。"},
{"role": "assistant", "content": "你好小明！很高兴认识你~"},
{"role": "user", "content": "请根据我的背景，帮我制定一个为期30天的Python学习计划。"}
]
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=800,
messages=conversation
)
print("Claude回复：")
print(response.content[0].text)
# 保存本次回复，方便下次继续对话
conversation.append({"role": "assistant", "content": response.content[0].text})六、流式输出（实时显示回复，推荐！）
文件 claude_stream.py：
import anthropic
client = anthropic.Anthropic()
with client.messages.stream(
model="claude-sonnet-4-6",
max_tokens=800,
messages=[{"role": "user", "content": "请用中文写一首关于AI未来的小诗，风格温暖励志。"}]
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True) # 实时打印
print("\n")七、完整可运行模板（推荐保存备用）
把下面代码保存为 claude_template.py，以后直接改 prompt 就能用：
import anthropic
import os
# 如果环境变量没设置，可以在这里手动填写（不推荐）
# os.environ["ANTHROPIC_API_KEY"] = "sk-ant-xxx"
client = anthropic.Anthropic()
def ask_claude(prompt: str, model: str = "claude-sonnet-4-6"):
response = client.messages.create(
model=model,
max_tokens=1024,
temperature=0.7,
messages=[{"role": "user", "content": prompt}]
)
return response.content[0].text
# 使用示例
if __name__ == "__main__":
result = ask_claude("帮我用Python写一个简单的猜数字小游戏代码，并加上详细中文注释。")
print(result)八、常见错误与避坑
- Invalid API key：Key 没设置或复制时有空格 → 重新运行 export 命令
- Rate limit：免费额度用完 → 等几小时或在 Console 充值
- Model not found：模型名写错 → 推荐用 claude-sonnet-4-6 或 claude-opus-4-6
- 想永久保存 Key：Windows 去“系统环境变量”设置；Mac/Linux 加到 ~/.zshrc
总结
用 Python 调用 Claude API 超级简单，只需三步：安装 SDK → 设置 API Key → 调用 client.messages.create()。
掌握上面的基础、多轮、流式三个示例，你就已经可以把 Claude 集成到自己的工具、自动化脚本或小项目中了。
现在就复制第一个 claude_basic.py 运行试试吧！
运行成功后，欢迎在评论区分享你的第一个 Claude API 调用结果，或者贴出你想实现的功能，我可以帮你写对应代码。
官方链接：
API 文档快速开始：https://platform.claude.com/docs/en/get-started
Python SDK 参考：https://platform.claude.com/docs/en/api/client-sdks
模型列表：https://platform.claude.com/docs/en/about-claude/models/overview
Console 管理 Key：https://console.anthropic.com/settings/keys