使うモデルは決まりました。でも、父が写真を撮るたびに、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)がそばで言葉を添えるわけにはいきません。Claude には、毎回、何と頼めばいいのでしょう。
問い
佐藤さんの疑問
作品の中の Claude に、毎回同じ役目を果たしてもらうには、どうすればいいんだろう。

前の回で、佐藤さんは、作品の中で使うモデル(AI の中身の版)を決めました。この回では、作品の中の Claude に、何を、どう頼むかを決め、Claude Code に読み取りの機能を作ってもらいます。
システムプロンプト:毎回伝える、役目と決まり
作品の中の Claude は、お父さんが写真を撮るたびに呼ばれます。そのたびに同じ役目を果たしてもらうために、毎回のリクエスト(頼みごと)に、役目と決まりを書いた文を添えます。これを、システムプロンプトと呼びます。
決まりを、
架空の
第1部の第11回で、AI への頼みごとの文をプロンプトと呼ぶ、と見ました。システムプロンプトは、その中でも、作品の作り手が前もって決めておく、土台の頼みごとです。Claude API の公式の説明には、こう書かれています。
“A system prompt is a way of providing context and instructions to Claude, such as specifying a particular goal or role.”
システムプロンプトは、Claude に、背景と指示を与えるための方法です。たとえば、目指すことや、役目を決めることができます。
佐藤さんのシステムプロンプト

佐藤さんは、次のように決めました。この文は、説明のための架空の例です。
あなたは、和菓子の店のノートの写真から、売れ残りの数を読み取る係です。
・読むのは、お菓子の名前と、その横に書かれた売れ残りの数だけです。
・お菓子の名前は、次の6つのどれかです:豆大福、どら焼き、栗まんじゅう、草餅、最中、練り切り(季節)。
・数が読めない、または自信がないときは、推測せず、「読めない」としてください。
・写真に、お菓子の売れ残り以外のこと(人の名前、電話番号、お金の額など)が写っていても、書き写さないでください。
・答えは、お菓子の名前と数の組だけを返してください。説明の文は要りません。ポイントは、3つです。
- 役目を1つに絞る:何をする係かを、最初の1文で言う
- しないことを書く:推測しない、ほかの情報を書き写さない
- 困ったときの決まりを書く:読めないときは「読めない」と返す
最後の「読めない」は、とくに大事です。決まりがないと、Claude は、それらしい数を埋めてしまうことがあります。第6部の第10回で、くわしく見ます。
Claude Code に、読み取りの機能を作ってもらう
システムプロンプトが決まったら、作るのは Claude Code です。第4部の第3回で見た依頼文の形(目的・範囲・確かめ方)で頼みます。
【目的】「写真を撮る」で撮ったノートの写真を、Claude API に送り、お菓子の名前と売れ残りの数を読み取って、「2. 売れ残りを確かめる」の表に入れたいです。
【今回の範囲】
・モデルは claude-haiku-5-5 を使ってください。使う前に、Claude API の公式のモデルの一覧で、いま使える名前か確かめてください。
・API キーは ANTHROPIC_API_KEY という環境変数から読んでください。鍵がブラウザに届かないよう、API はサーバー側から呼んでください。
・システムプロンプトは、下に貼る文をそのまま使ってください。
・答えは、決まった形(お菓子の名前と数の組)で受け取ってください。
・読み取った数は、表に入れるだけにして、自動でどこかに送らないでください。
【確かめ方】作る前に、計画と、1回の読み取りで送るトークンのおおよその数と料金を教えてください。
(ここに、システムプロンプトを貼る)この依頼文は、説明のための架空の例です。Claude Code の入力欄に、最後の「(ここに、システムプロンプトを貼る)」のところへ、上のシステムプロンプトを貼ってから送ります。「鍵がブラウザに届かないよう、サーバー側から」については、次の回で見ます。
作品の中の Claude には、システムプロンプトで、役目と、しないことと、困ったときの決まりを、毎回伝えます。
注意
ただし、システムプロンプトに書いても、必ず守られるとは限らない
システムプロンプトは、強い頼みごとですが、絶対の決まりではありません。写真が暗かったり、思わぬものが写っていたりすると、決まりから外れた答えが返ることがあります。
だから、作品の側でも、返ってきた答えを確かめる仕組みを作ります。それが、第6部の第10回の話です。
なお、作品が、使う人から薬の量を聞かれるかもしれないときは、システムプロンプトに、そのまま入れるよう決められた文が、Claude API の公式の説明にあります。健康や医療にかかわる作品の注意は、第8部で扱います。
次回の問い
佐藤さんの次の疑問です。依頼文にあった「鍵がブラウザに届かないよう、サーバー側から」とは、どういうことでしょうか。