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