読み込み中
読み込み中

Claudeを使ってアプリケーションを構築する際、リクエストのライフサイクル全体を理解しておくと、より優れたアーキテクチャ上の意思決定を行い、問題をより効果的にデバッグできるようになります。ここでは、チャットインターフェースでユーザーが「送信」をクリックした瞬間から、Claudeの応答が画面に表示されるまでに何が起こるかを見ていきましょう。

「You」からの「What is quantum computing?」というメッセージ、空の入力ボックス、送信ボタンが表示されたチャットウィンドウ。

5ステップのリクエストフロー

Claudeとのやり取りはすべて、サーバーへのリクエスト、Anthropic APIへのリクエスト、モデルによる処理、サーバーへのレスポンス、クライアントへのレスポンスという5つの明確なフェーズからなる予測可能なパターンに従います。

ステップ1「サーバーへのリクエスト」:Webアプリまたはモバイルアプリが「What is quantum computing?」をリクエストとして自分のサーバーに送信する。

サーバーが必要な理由

クライアント側のコードからAnthropic APIに直接リクエストを送ることは絶対に避けるべきです。理由は以下の通りです。

  • APIリクエストには認証のための秘密のAPIキーが必要です
  • このキーをクライアントコード内に露出させると、深刻なセキュリティ上の脆弱性が生まれます
  • 誰でもそのキーを抽出して、不正なリクエストを行うことができてしまいます

そうではなく、Webアプリやモバイルアプリは自分のサーバーにリクエストを送り、そのサーバーが安全に保管されたキーを使ってAnthropic APIと通信します。

APIリクエストの送信

サーバーがAnthropic APIにアクセスする際には、公式SDKを使うことも、通常のHTTPリクエストを直接行うこともできます。AnthropicはPython、TypeScript、JavaScript、Go、Rubyに対応したSDKを提供しています。

「Anthropic APIへのリクエスト」ステップ:入力テキストが「user」メッセージの中に入れられ、そのメッセージがメッセージのリストに入れられる。

すべてのリクエストには、以下の必須フィールドを含める必要があります。

  • API Key - リクエストをAnthropicに対して識別します
  • Model - 使用するモデルの名前(「claude-haiku-4-5」など)
  • Messages - ユーザーの入力テキストを含むリスト
  • Max Tokens - Claudeが生成できるトークン数の上限

Claudeの処理の内部

Anthropicがリクエストを受け取ると、Claudeはトークン化、埋め込み、文脈化、生成という4つの主要な段階を経てそれを処理します。

トークン化:ユーザー入力「What is quantum computing?」がトークン「What」「is」「quantum」「computing」「?」に分割される。

トークン化

Claudeはまず、入力テキストをトークンと呼ばれる小さな単位に分割します。これは単語全体の場合もあれば、単語の一部、スペース、記号の場合もあります。簡単に考えるために、各単語を1つのトークンとみなしてください。

埋め込み

各トークンは埋め込み(embedding)に変換されます。これは、その単語が持ちうるすべての意味を表す長い数値のリストです。埋め込みは、意味的な関係を捉える数値的な定義だと考えてください。

「quantum」から以下に挙げる4つの意味と、「どれだけ」を意味するラテン語の語源「quantus」へ枝分かれする図。

単語には複数の意味がある場合がよくあります。例えば、「quantum」は以下のいずれかを指す可能性があります。

  • 物理量の離散的な単位(物理学)
  • 量子力学や量子物理学の概念
  • 極めて小さい、または原子以下のスケールのもの
  • 量子コンピューティングの応用

文脈化

Claudeは周囲の単語に基づいて各埋め込みを調整し、文脈の中で最も可能性の高い意味を判断します。このプロセスでは、数値表現を調整して適切な定義を際立たせます。

Anthropic APIの文脈化の段階が、-0.34や0.87などの小数が並ぶ5つの列につながり、列同士が弧で結ばれている図。

生成

文脈化された埋め込みは出力層を通過し、次に来る可能性のある単語それぞれについて確率が計算されます。Claudeは常に最も確率の高い単語を選ぶわけではなく、確率と制御されたランダム性を組み合わせて、自然で多様性のある応答を作り出します。

出力層から得られる次の単語の確率:「Quantum」30%、「Great」23%、「Are」19%、「What」10%、「This」10%、「To」8%。

各単語を選択した後、Claudeはそれをシーケンスに追加し、次の単語に対して同じプロセス全体を繰り返します。

Claudeが生成を停止するタイミング

各トークンの後、Claudeは続行すべきかどうかを判断するためにいくつかの条件をチェックします。

出力トークン「Quantum mechanics is a form of computing.」がシーケンス終了トークンで終わり、以下の3つの停止チェックが示されている図。

  • 最大トークン数に到達 - 指定した上限に達したか?
  • 自然な終了 - シーケンス終了トークンを生成したか?
  • 停止シーケンス - あらかじめ定義された停止フレーズに遭遇したか?

APIのレスポンス

生成が完了すると、APIは以下を含む構造化されたレスポンスを返します。

  • Message - 生成されたテキスト
  • Usage - 入力トークンと出力トークンの数
  • Stop Reason - 生成が終了した理由

Anthropic APIから自分のサーバー上のAnthropic SDKへレスポンスが返され、出力テキストが「assistant」メッセージに含まれている図。

サーバーはこのレスポンスを受け取り、生成されたテキストをクライアントアプリケーションに転送します。そして、それがユーザーインターフェースに表示されます。

チャットアプリの質問「What is quantum computing?」が自分のサーバーのAnthropic SDK、次にAnthropic APIへ送られ、戻ってくる流れ。

重要なポイント

このフローを理解することで、以下のことができるようになります。

  • APIキーを保護する安全なアーキテクチャを設計する
  • 自分のユースケースに適したトークン数の上限を設定する
  • アプリケーションのロジックの中で、さまざまな停止理由を適切に処理する
  • パイプラインのどこで問題が起こり得るかを理解し、問題をデバッグする

すべての詳細を暗記する必要はありません。ここでの目標は、ClaudeのAPIを扱う際に出会う用語や全体のプロセスに慣れ親しむことです。