JSON、Pythonコード、箇条書きリストなど、構造化データをClaudeに生成させたい場合、よくある問題にぶつかります。それは、Claudeが役に立とうとして、説明文、見出し、またはMarkdown形式の装飾をコンテンツの周りに追加してしまうことです。この余分な解説は、生のデータだけが必要なときにユーザー体験を損ないます。

AWS EventBridgeのルールを生成するWebアプリを構築する場合を考えてみましょう。ユーザーは説明を入力し、generateをクリックして、すぐにコピーして使用できるクリーンなJSONが表示されることを期待します。もしClaudeがJSONをMarkdownのコードブロックで囲み、説明文を添えて返すと、ユーザーはレスポンス全体をそのままコピーすることができず、JSON部分だけを手動で選択しなければなりません。
デフォルトのレスポンスが抱える問題
デフォルトでは、Claudeは構造化された出力を次のような形式で返す傾向があります。
# EventBridge Rule
```json
{
"source": ["aws.ec2"],
"detail-type": ["EC2 Instance State-change Notification"],
"detail": {"state": ["running"]}
}
```
This rule captures EC2 instance state changes when instances start running or stop.これはドキュメント作成には最適ですが、プログラムで使用するためにJSONだけが必要な場合には問題になります。
解決策:アシスタントメッセージのプリフィル+ストップシーケンス
アシスタントメッセージのプリフィルとストップシーケンスを組み合わせることで、まさに求めているコンテンツだけを取得できます。仕組みは次のとおりです。
messages = []
add_user_message(messages, "Generate a very short event bridge rule as json")
add_assistant_message(messages, "```json")
text = chat(messages, stop_sequences=["```"])このテクニックは以下のように機能します。
- アシスタントメッセージに、開始側のMarkdown区切り文字をプリフィルする
- Claudeがコードブロックを閉じようとしたときに生成を停止するストップシーケンスを設定する
- これらの区切り文字の間のコンテンツだけを取得する

裏側での動作の仕組み
Claudeがリクエストを受け取ると、プリフィルされたアシスタントメッセージを認識し、すでにJSONコードブロックを書き始めたものとみなします。独自の見出しや開始側の区切り文字を追加する代わりに、Claudeは実際のJSONコンテンツの生成に直接進みます。
Claudeが JSON を書き終えて、自然な流れで ``` を使ってMarkdownコードブロックを閉じようとすると、ストップシーケンスが即座に生成を停止し、レスポンスを返します。余分な装飾のないJSONコンテンツだけが得られます。
結果の処理
返されたテキストには改行文字が含まれる場合がありますが、簡単にクリーンアップできます。
import json
# JSONとして解析し、検証・整形する
parsed_data = json.loads(text.strip())
# それ以外のデータ型は空白を取り除くだけにする
clean_text = text.strip()JSON以外にも
このテクニックはJSON生成に限定されるものではありません。Claudeが説明文を追加しようとする自然な傾向を避けて、コンテンツだけが欲しい構造化データであれば、どのようなものにも使用できます。
- Pythonコードスニペット
- 箇条書きリスト
- CSVデータ
- 設定ファイル
- クリーンでコピー可能な出力が重要な、あらゆる形式
重要なのは、対象とするコンテンツタイプの周りでClaudeが自然に使用しそうな区切り文字を見極め、その開始側の区切り文字をプリフィルし、終了側の区切り文字で停止することです。これにより、Claudeの自然な書式設定の傾向を活かしながら、出力形式を正確にコントロールできます。