加载中
加载中

在使用 Claude 构建应用程序时,理解完整的请求生命周期有助于您做出更好的架构决策,并更有效地调试问题。让我们一起了解从用户在您的聊天界面中点击"发送"的那一刻起,到 Claude 的响应出现在屏幕上之间发生的所有事情。

聊天窗口中有一条来自"您"的消息,内容是"什么是量子计算?",下方是一个空白输入框和一个发送按钮。

五步请求流程

与 Claude 的每次交互都遵循一个可预测的模式,包含五个不同的阶段:请求发送到服务器、请求发送到 Anthropic API、模型处理、响应返回服务器、响应返回客户端。

步骤 1,请求发送到服务器:Web 或移动应用将"什么是量子计算?"作为请求发送到您的服务器。

为什么需要服务器

您永远不应该直接从客户端代码向 Anthropic API 发出请求。原因如下:

  • API 请求需要一个用于身份验证的密钥(API 密钥)
  • 在客户端代码中暴露该密钥会造成严重的安全漏洞
  • 任何人都可以提取该密钥并发出未经授权的请求

相反,您的 Web 或移动应用会将请求发送到您自己的服务器,然后由服务器使用安全存储的密钥与 Anthropic API 进行通信。

发出 API 请求

当您的服务器与 Anthropic API 通信时,您可以使用官方 SDK 或直接发出普通的 HTTP 请求。Anthropic 为 Python、TypeScript、JavaScript、Go 和 Ruby 提供了 SDK。

请求发送到 Anthropic API 步骤:输入文本被放置在一个"user"消息中,然后该消息被放入消息列表中。

每个请求都必须包含以下基本字段:

  • API 密钥(API Key) - 向 Anthropic 标识您的请求
  • 模型(Model) - 要使用的模型名称(例如"claude-haiku-4-5")
  • 消息(Messages) - 包含用户输入文本的列表
  • 最大令牌数(Max Tokens) - 限制 Claude 可以生成的令牌数量

Claude 处理过程内部揭秘

一旦 Anthropic 收到您的请求,Claude 会通过四个主要阶段对其进行处理:分词(tokenization)、嵌入(embedding)、上下文化(contextualization)和生成(generation)。

分词:用户输入"什么是量子计算?"被拆分为令牌"什么"、"是"、"量子"、"计算"和"?"。

分词

Claude 首先将您的输入文本分解成称为令牌(token)的较小片段。这些可以是完整的单词、单词的一部分、空格或符号。为简单起见,可以将每个单词视为一个令牌。

嵌入

每个令牌都会被转换为一个嵌入(embedding)——一长串数字,代表该词所有可能的含义。可以将嵌入视为捕捉语义关系的数值定义。

图示展示"quantum"(量子)分支出下方列出的四种含义,以及它的拉丁词根"quantus",意为"多少"。

单词通常具有多种含义。例如,"quantum"(量子)可能指:

  • 物理量的离散单位(物理学)
  • 量子力学或量子物理学概念
  • 极小或亚原子的事物
  • 量子计算应用

上下文化

Claude 会根据周围的词语来精炼每个嵌入,以确定在上下文中最可能的含义。这个过程会调整数值表示,以突出适当的定义。

Anthropic API 的上下文化阶段与五列小数(如 -0.34 和 0.87)相连,并通过弧线连接。

生成

经过上下文化的嵌入会通过一个输出层,该层会计算每个可能的下一个词的概率。Claude 并不总是选择概率最高的词——它会结合概率与可控的随机性,以创建自然、多样的响应。

来自输出层的下一个词概率:30% "Quantum",23% "Great",19% "Are",10% "What",10% "This",8% "To"。

选择每个词之后,Claude 会将其添加到序列中,并对下一个词重复整个过程。

Claude 何时停止生成

在每个令牌之后,Claude 都会检查几个条件来决定是否继续:

输出令牌"Quantum mechanics is a form of computing."以一个序列结束令牌结束,下方是三项停止检查。

  • 达到最大令牌数 - 是否已达到您指定的限制?
  • 自然结束 - 是否生成了一个序列结束令牌?
  • 停止序列 - 是否遇到了预定义的停止短语?

API 响应

生成完成后,API 会返回一个结构化的响应,其中包含:

  • 消息(Message) - 生成的文本
  • 用量(Usage) - 输入和输出令牌的计数
  • 停止原因(Stop Reason) - 生成结束的原因

响应从 Anthropic API 流回您服务器上的 Anthropic SDK,输出文本位于一条"assistant"消息中。

您的服务器接收此响应,并将生成的文本转发回您的客户端应用程序,然后该文本会出现在用户界面中。

聊天应用中的问题"什么是量子计算?"发送到您服务器上的 Anthropic SDK,再到 Anthropic API,然后返回。

关键要点

理解这一流程有助于您:

  • 设计能够保护您 API 密钥的安全架构
  • 为您的用例设置合适的令牌限制
  • 在您的应用逻辑中处理不同的停止原因
  • 通过理解问题可能发生在流程中的哪个环节来调试问题

不必担心记住每一个细节——目标是让您熟悉在使用 Claude API 时会遇到的术语和整体流程。