Claude API 是 Anthropic 官方提供的接口,让你可以在自己的代码里直接调用 Claude(Opus 4.6、Sonnet 4.6 等最新模型)。2026年新手也能在10分钟内完成第一次调用,本教程全程保姆级,从注册到运行代码,一步一步手把手教你。
所有步骤基于 Anthropic 官方文档(2026年3月最新)和 Python SDK,零编程基础也能轻松上手。
一、Claude API 是什么?为什么值得新手学?
Claude API 可以让你在自己的程序里调用 Claude 的强大能力,比如自动生成文章、分析数据、写代码、做智能助手等。
优点:
- 模型智能(2026最新 Opus 4.6 / Sonnet 4.6 推理能力强)
- 上下文超长
- 安全可靠
- 按使用付费(新手免费额度够测试)
10分钟目标:成功调用一次,让 Claude 回复“Hello, Claude”。
二、准备工作(2分钟)
1. 安装 Python(如果没有)
去官网 https://www.python.org 下载最新版(推荐 3.10+),安装时勾选“Add to PATH”。
2. 打开命令行工具
- Windows:搜索“PowerShell”或“命令提示符”
- Mac/Linux:打开 Terminal
三、注册账号并获取 API Key(3分钟)
1. 打开浏览器,访问 Anthropic Console:https://console.anthropic.com
2. 用 Google 账号或邮箱注册/登录。
3. 登录后点击左侧 “API keys” 或直接访问 https://console.anthropic.com/settings/keys
4. 点击 “Create key”,给 Key 起个名字(例如 “my-first-key”),点击创建。
5. 复制生成的 API Key(格式类似 sk-ant- 开头),**立即保存到安全地方**(Key 只显示一次)。
重要提醒:不要把 Key 上传到 GitHub 或分享给别人,否则会被盗用扣费。
四、安装 Claude Python SDK(1分钟)
在命令行工具中运行下面命令:
pip install anthropic
等待安装完成即可(可能需要几秒到几十秒)。
五、设置 API Key 并写第一个代码(2分钟)
1. 在命令行设置环境变量(临时,一次性):
Mac / Linux:
export ANTHROPIC_API_KEY="你的API-Key-粘贴在这里"
Windows PowerShell:
$env:ANTHROPIC_API_KEY="你的API-Key-粘贴在这里"
2. 创建一个新文件,命名为 claude_first_call.py,用记事本或 VS Code 打开,复制下面完整代码:
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-sonnet-4-6", # 2026推荐新手模型,速度快质量好
max_tokens=300, # 最大回复长度
messages=[
{
"role": "user",
"content": "你好,我是第一次使用 Claude API 的新手,请用中文简单介绍一下你自己。"
}
]
)
print(message.content[0].text)
3. 保存文件。
六、运行代码并看到结果(1分钟)
在命令行进入文件所在目录(例如 cd Desktop),然后运行:
python claude_first_call.py
看到 Claude 的中文回复,就代表调用成功!🎉
第一次可能稍慢,之后会更快。
七、常用参数快速说明(新手必知)
- model:推荐新手用
claude-sonnet-4-6(平衡型);想更强用claude-opus-4-6 - max_tokens:控制回复长度(300~4096 都行)
- messages:对话列表,支持多轮(role 可以是 user 或 assistant)
- temperature:加到 create() 里,0.0~1.0(0 最稳定,1 最有创意)
想流式输出(边生成边显示)?把 messages.create 改成 messages.stream 即可。
八、常见问题与避坑
- 报错 “Invalid API key” → Key 没复制完整或没设置环境变量
- 报错 “rate limit” → 免费额度用完,稍等或充值
- 想长期使用 → 把 Key 写到 .env 文件或系统环境变量
- Windows 命令行不认 export → 用 PowerShell 的 $env: 方式
更多示例可直接看官方 Quickstart:https://platform.claude.com/docs/en/get-started
总结
恭喜你!10分钟内就完成了 Claude API 的第一次调用。从现在开始,你可以在自己的代码里自由使用 Claude 的强大能力了。
下一步建议:
- 尝试多轮对话(加几个 messages)
- 试试让它生成代码或分析数据
- 学习 Tool Use(让 Claude 调用外部工具)
API 调用成功后,Claude 就不再只是网页聊天工具,而是你程序里的超级助手。
现在就去运行你的第一个代码吧!欢迎在评论区贴出你的运行结果或遇到的问题,我可以帮你继续调试。
官方链接:
Console 获取 Key:https://console.anthropic.com/settings/keys
官方文档:https://platform.claude.com/docs/en/get-started
Python SDK 参考:https://platform.claude.com/docs/en/api/sdks/python
模型列表:https://platform.claude.com/docs/en/about-claude/models/overview