Claude に文章を書かせる｜頼み方・決まった形の答え・出典つきの答え

何を渡して、何を書いてもらうか

Claude に渡すのは、レッスン6で計算した順位と、各記事の短い説明だけです。書いてもらうのは、ランキングの最初のひとことと、1本ずつの紹介文です。順位やアクセス数は、文章には書かせません。数字はページの側で、計算した値をそのまま出します。

モデルは、公式の表でコンテンツ作りの例が挙がっている Sonnet 5.5 から試すとよいでしょう。公式は、自分の題材で書かせてみて、くらべて決めるようすすめています。

伝わる頼み方の4つ

公式の頼み方のガイドは、Claude を「とても優秀だけれど、事情をまだ知らない新しい人」と考えるようすすめています。API で頼むときも、コース1・2で学んだ頼み方と同じです。

決まった形で受け取る（構造化出力）

答えをプログラムで使うときは、構造化出力を使います。答えの形（JSON スキーマ）を先に渡すと、Claude はその形どおりの JSON で答えます。公式は、ほとんどの場合この形どおりになることを保証しています。

ただし、Claude が答えを断ったとき（stop_reason が refusal）と、書ける量の上限（max_tokens）に届いて途中で切れたとき（max_tokens）は、形どおりにならないことがあります。stop_reason が、書き終わったしるしの end_turn でなければ、保存せずに止めるようにしておきます。また、構造化出力では文字数の決まり（何文字以上など）は指定できません。「40〜120文字」は頼み方で伝え、守れているかはレッスン10の機械のチェックで確かめます。なお、最近のモデルでは、答えの書き出しを先に渡しておく方法は使えません。形をそろえたいときは、構造化出力を使います。

出典つきで書かせる（Citations）

ニュースのまとめのように、「どこに書いてあったか」を示したい文章もあります。そのときは Citations（出典つきの答え）を使います。資料を文書として渡し、出典の機能をオンにすると、Claude は答えの文ごとに、資料のどこから引いたかを返します。

猫のランキングは、数字はプログラムが出し、紹介文は記事の説明をもとにするので、構造化出力で十分です。出典を見ながら事実を確かめたい題材では Citations を使います（レッスン13の実例は、出典つきです）。

やってみよう

1. レッスン6で作った data/ranking/ の JSON を用意します
2. 下の「答えの形（JSON スキーマ）」を scripts/ranking-schema.json として保存します
3. 「いいな」と思う紹介文を2つ書いて、scripts/examples.txt として保存します（1本につき2文・40〜120文字・数字なし）
4. 下の依頼文を Claude Code に送って、紹介文を書かせるプログラムを作ってもらいます（APIキーはレッスン4と同じく、別のターミナルの環境変数に）
5. できた紹介文を読んで、数字や記事の中身とちがうことを書いていないか確かめます

確認問題