# 一、什么是 Claude APIClaude 是由 Anthropic 公司开发的 AI 大语言模型能够完成对话、写作、 代码生成 、数据分析等多种任务。Claude API 允许开发者通过编程方式调用这些能力将 AI 集成到自己的应用中。与直接使用 Claude 网页版不同通过 API 调用可以- 将 AI 能力集成到你的产品或工具中- 批量处理大量文本任务- 自定义系统提示词控制模型行为- 实现流式输出等高级功能# 二、前期准备# 2.1 获取 API Key调用 Claude API 需要一个有效的 API Key。国内开发者有两种方式获取**方式一注册 Anthropic 官方账号**- 需要境外手机号验证- 需要境外支付方式充值- 网络访问需要代理**方式二使用国内 API 中转平台推荐**对于国内开发者更推荐通过**库拉c.kulaai.cn** 这类中转平台获取 API Key- 国内直连无需翻墙- 支持支付宝/微信充值- 兼容 Anthropic SDK 接口格式访问**c.kulaai.cn**注册账号后在控制台新建 API Key。![](https://i-blog.csdnimg.cn/direct/d4d06a2f23934dd79d039d7dda74c8c7.jpg)# 2.2 安装 Python 环境确保你已安装 Python 3.8 或以上版本python --version # 确认版本# 2.3 安装 SDKpip install anthropic如果你习惯使用 OpenAI SDK也可以用 OpenAI 的兼容模式pip install openai# 三、第一次调用 Claude API# 3.1 最简单的调用示例import anthropic # 初始化客户端 client anthropic.Anthropic( api\_keyyour-api-key-here, # 替换为你的 API Key base\_urlhttps://api.jiekou.ai # 国内中转端点无需翻墙 ) # 发送消息 message client.messages.create( modelclaude-3-7-sonnet-20250219, # 使用 Claude 3.7 Sonnet max\_tokens1024, messages\[ {role: user, content: 你好请用一段话介绍一下你自己。} \] ) # 打印回复 print(message.content\[0\].text)运行后如果看到 Claude 的自我介绍说明接入成功# 3.2 理解返回结果API 返回的 message 对象包含以下重要字段print(message.id) # 消息唯一 ID print(message.model) # 实际使用的模型 print(message.content\[0\].text) # 回复文本内容 print(message.usage.input\_tokens) # 输入 token 数量 print(message.usage.output\_tokens) # 输出 token 数量# 3.3 使用 OpenAI SDK 兼容模式如果你的项目已使用 OpenAI SDK可以通过以下方式调用 Claudefrom openai import OpenAI client OpenAI( api\_keyyour-api-key-here, base\_urlhttps://api.jiekou.ai/v1 ) response client.chat.completions.create( modelclaude-3-7-sonnet-20250219, messages\[ {role: user, content: 你好请用一段话介绍一下你自己。} \] ) print(response.choices\[0\].message.content)# 四、核心功能详解# 4.1 添加 System PromptSystem Prompt 用于设定模型的角色和行为规范message client.messages.create( modelclaude-3-7-sonnet-20250219, max\_tokens1024, system你是一位专业的 Python 编程导师擅长用简单易懂的方式解释复杂概念。回答时请使用中文并配合代码示例。, messages\[ {role: user, content: 什么是装饰器decorator} \] )# 4.2 多轮对话通过保留对话历史实现上下文连续的多轮对话conversation\_history \[\] def chat(user\_message):conversation\_history.append({ role: user, content: user\_message }) response client.messages.create( modelclaude-3-7-sonnet-20250219, max\_tokens1024, messagesconversation\_history ) assistant\_message response.content\[0\].textconversation\_history.append({ role: assistant, content: assistant\_message }) return assistant\_message # 多轮对话示例 print(chat(请介绍一下 Python 的列表推导式)) print(chat(能给我一个实际应用的例子吗)) print(chat(和 for 循环相比它有什么优劣势))# 4.3 调整生成参数message client.messages.create( modelclaude-3-7-sonnet-20250219, max\_tokens2048, # 最大输出 token 数 temperature0.7, # 创意度0-1越高越随机 top\_p0.9, # 核采样参数 messages\[ {role: user, content: 写一首关于秋天的诗} \] )# 五、常见报错与解决方法# 5.1 AuthenticationError认证失败anthropic.AuthenticationError: Error code: 401**原因**API Key 不正确或已失效。 **解决**检查 API Key 是否完整复制是否过期或重新生成。# 5.2 ConnectionError连接超时httpx.ConnectError: \[Errno -2\] Name or service not known**原因**无法访问 API 端点通常是网络问题。 **解决**如果使用官方端点需要开启代理推荐改用 jiekou.ai 中转服务国内直连。# 5.3 RateLimitError频率超限anthropic.RateLimitError: Error code: 429**原因**请求频率超过账号限制。 **解决**加入延迟重试逻辑或升级账号套餐。# 5.4 InvalidRequestError请求格式错误anthropic.BadRequestError: Error code: 400**原因**请求参数格式不正确例如 messages 格式有误。 **解决**检查 messages 列表格式确保每个元素包含 role 和 content 字段。# 六、加入错误处理的完整示例import anthropic import time def call\_claude(prompt, system\_promptNone, max\_retries3): 调用 Claude API包含错误处理和重试逻辑 Args: prompt: 用户输入 system\_prompt: 系统提示词可选 max\_retries: 最大重试次数 Returns: 回复文本或 None client anthropic.Anthropic( api\_keyyour-api-key-here, base\_urlhttps://api.jiekou.ai ) kwargs { model: claude-3-7-sonnet-20250219, max\_tokens: 1024, messages: \[{role: user, content: prompt}\] } if system\_prompt: kwargs\[system\] system\_prompt for attempt in range(max\_retries): try: message client.messages.create(\*\*kwargs) return message.content\[0\].text except anthropic.RateLimitError: if attempt max\_retries - 1: wait\_time 2 \*\* attempt print(f频率超限{wait\_time}秒后重试...) time.sleep(wait\_time) else: print(达到最大重试次数请求失败) raise exceptanthropic.AuthenticationError: print(API Key 验证失败请检查密钥) raise except Exception as e: print(f请求出错{e}) raise # 使用示例 result call\_claude( prompt用 Python 写一个快速排序算法, system\_prompt你是一位经验丰富的算法工程师用简洁高效的代码解决问题 ) print(result)# 七、Claude API 支持的模型列表通过 jiekou.ai 中转平台可以调用的 Claude 模型table stylemin-width: 168px;colgroupcolcolcol/colgrouptbodytrtdp模型名称/p/tdtdp模型 ID/p/tdtdp特点/p/td/trtrtdp classsyl-line-pure-englishClaude 3.7 Sonnet/p/tdtdp classsyl-line-pure-englishclaude-3-7-sonnet-20250219/p/tdtdp最新旗舰支持扩展思考/p/td/trtrtdp classsyl-line-pure-englishClaude 3.5 Sonnet/p/tdtdp classsyl-line-pure-englishclaude-3-5-sonnet-20241022/p/tdtdp综合能力强代码优秀/p/td/trtrtdp classsyl-line-pure-englishClaude 3.5 Haiku/p/tdtdp classsyl-line-pure-englishclaude-3-5-haiku-20241022/p/tdtdp速度快成本低/p/td/trtrtdp classsyl-line-pure-englishClaude 3 Opus/p/tdtdp classsyl-line-pure-englishclaude-3-opus-20240229/p/tdtdp精度最高成本也最高/p/td/tr/tbody/table# 结语Claude API 的调用流程并不复杂安装 SDK → 获取 API Key → 修改 base\_url → 发起调用整个过程只需几分钟。对于国内开发者通过库拉c.kulaai.cn 中转平台可以省去翻墙和境外支付的麻烦直接接入 Claude 全系模型。按量计费没有隐藏费用适合从测试到生产的各个阶段。如果在接入过程中遇到问题欢迎参考本文的常见报错章节大多数问题都有明确的解决方案。