Claude API 新手入门指南：从零开始构建你的第一个对话应用

1次阅读

共计 2386 个字符，预计需要花费 6 分钟才能阅读完成。

Claude 是 Anthropic 公司开发的大型语言模型，通过 API 可以轻松集成到各种应用中。相比自行部署模型，使用 API 有以下优势：

无需担心基础设施 ：省去服务器维护和模型部署的麻烦
按需付费 ：只需为实际使用的 token 数量付费
持续更新 ：后台模型会自动升级到最新版本
内置安全机制 ：相比开源模型有更好的内容过滤

访问 Anthropic 官网并注册开发者账号
在控制台中找到 API Keys 部分
点击 ”Create Key” 生成新的密钥
妥善保存密钥（建议使用环境变量存储）

推荐使用 Python 3.8+ 版本，安装官方 SDK：

pip install anthropic

以下是一个发送单个消息并获取回复的示例：

import anthropic

client = anthropic.Anthropic(api_key="你的 API 密钥")

response = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=100,
    messages=[{"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

print(response.content)

关键参数说明：

model: 指定要使用的 Claude 模型版本
max_tokens: 限制响应长度（1 个 token≈1 个英文单词）
messages: 对话历史列表，每个消息包含 role(user/assistant) 和 content

API 返回的响应对象包含以下重要属性：

# 获取回复文本
reply = response.content[0].text

# 获取使用的 token 数量
input_tokens = response.usage.input_tokens
output_tokens = response.usage.output_tokens

temperature (0-1): 控制创造性，值越高回答越多样
top_p (0-1): 类似 temperature，但效果更稳定
system 提示：可以设置 AI 的初始角色和行为

response = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=200,
    temperature=0.7,
    system="你是一个乐于助人的 AI 助手，回答要简洁专业",
    messages=[...]
)

Claude 支持多轮对话，只需在 messages 中维护完整的对话历史：

conversation = [{"role": "user", "content": "推荐几本人工智能入门的书"},
    {"role": "assistant", "content": "《人工智能：现代方法》是不错的选择..."},
    {"role": "user", "content": "中文版的有什么推荐吗？"}
]

response = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=100,
    messages=conversation
)

超出 token 限制 ：
解决方案：检查 max_tokens 设置，或拆分长文本
API 密钥无效 ：
确认密钥正确且未过期
检查环境变量名是否正确
响应速度慢 ：
尝试使用较小模型（如 claude-3-sonnet）
减少 max_tokens 值

始终添加异常处理
记录 API 调用日志
监控 token 使用量
对用户输入做基本过滤

try:
    response = client.messages.create(...)
except anthropic.APIConnectionError as e:
    print("连接失败:", e)
except anthropic.APIStatusError as e:
    print("API 错误:", e.status_code, e.response)

以下是一个完整的命令行聊天程序：

import anthropic

client = anthropic.Anthropic(api_key="你的 API 密钥")

conversation = []

print("欢迎使用 Claude 聊天助手 ( 输入' 退出 '结束)")

while True:
    user_input = input("你:")

    if user_input.lower() == '退出':
        break

    conversation.append({"role": "user", "content": user_input})

    try:
        response = client.messages.create(
            model="claude-3-sonnet-20240229",
            max_tokens=300,
            messages=conversation
        )

        reply = response.content[0].text
        print(f"Claude: {reply}")

        conversation.append({"role": "assistant", "content": reply})

    except Exception as e:
        print("发生错误:", str(e))