閉店後の店の奥で、お父さんが、いつものノートに鉛筆で売れ残りを書いています。豆大福 4、どら焼き 2、栗まんじゅう 0。
佐藤さん(商店街の和菓子店を手伝う、架空の人物)は、そのノートを見ながら、第4部で作った「売れ残り帳」に、+と−で数を入れ直します。第5部で、売れ残り帳は記録とともに GitHub に置けるようになりました。でも、ノートから打ち直す手間は、まだ残っています。
第3部で決めた3行の最後は、「写真を撮るだけで、数を読み取る」でした。Claude のチャットにノートの写真を渡せば、数を読み取ってくれることは、第3部で見ました。でもそれは、佐藤さんが Claude に話しかけたときの話です。お父さんが、売れ残り帳で写真を撮ったときの話ではありません。
問い
佐藤さんの疑問
お父さんが売れ残り帳で写真を撮ったら、その場で Claude が数を読んでくれるようにしたい。自分の作品の中から Claude に頼むには、どうしたらいいんだろう。
第6部では、この疑問に、10回かけて答えます。この回は、その入口です。
2つの Claude
誰が
作る
ここまで使ってきた Claude Code は、作品を作るための Claude でした。佐藤さんが話しかけ、Claude がファイルを作ります。
これから足すのは、作品の中で働く Claude です。お父さんが写真を撮ると、作品が Claude に写真を送り、読み取った数を受け取ります。話しかけるのは、佐藤さんではなく、作品です。払うところも、Claude のプランではなく、API の利用分(第2部の第10回)になります。
API:作品と Claude をつなぐ窓口

第1部の第10回で、作品から Claude に頼みごとを送り、答えを受け取るための、決まった受付窓口を API と呼ぶ、と説明しました。ウェブの作り方を解説している MDN というサイトには、こう書かれています。
“An API (Application Programming Interface) is a set of features and rules that exist inside a software program (the application) enabling interaction with it through software - as opposed to a human user interface.”
API は、ソフトウェア(アプリ)の中にある機能と決まりのまとまりで、人が画面を操作するのとは違い、ソフトウェアどうしでやり取りできるようにするものです。
お店で言えば、注文を受け付ける窓口のようなものです。決まった書き方の注文票を出せば、決まった形で品物が返ってきます。
リクエストとレスポンス
窓口に出す頼みごとを、リクエスト(request、英語で「頼みごと」)と呼びます。返ってくる答えを、レスポンス(response、英語で「返事」)と呼びます。
佐藤さんの作品なら、こうなります。
- リクエスト:ノートの写真と、「この写真から、お菓子の名前と、売れ残りの数を読み取ってください」という頼みごと
- レスポンス:「豆大福 4、どら焼き 2、栗まんじゅう 0…」という答え
作品が、
架空の
Claude API の公式の説明でも、作品が決まった送り先にリクエストを送ると、Claude の答えを含んだレスポンスが返る、という形で始め方が説明されています。リクエストには、どのモデル(AI の中身の版)を使うか、答えの長さの上限、頼みごとの中身を入れます。

作品の中で Claude を動かすには、API という窓口に、リクエストを送り、レスポンスを受け取ります。
注意
ただし、作品の中の Claude は、使うたびにお金がかかる
Claude Code は、Claude のプランの中で使えました。作品の中の Claude は、第2部の第10回で見たとおり、プランとは別の財布、API の利用分から支払います。お父さんが写真を撮るたびに、少しずつ使います。
どのくらいかかるのか、使いすぎをどう防ぐのかは、この第6部の中で見ていきます。
次回の問い
佐藤さんの次の疑問です。作品が API を使うとき、窓口は、どうやって「使ってよい相手」かを見分けているのでしょうか。