11月17日の午後、Platform のリリースノートを開いたところ、前日付けで短い一項目が増えていました。Claude Opus 4.6・Opus 4.5・Sonnet 4.5・Haiku 4.5 の生成テキストに、対応プラットフォームで Anthropic のテキスト透かしが入る、という告知です。
読み進めて手が止まったのは、その次の一文でした。これらのモデルへのリクエストで temperature・top_p・top_k のどれかを既定以外の値にすると、出力に透かしが付かない場合がある、と書かれています。
私は 10 月に、API バージョン 2026-10-21 への備えとしてサンプリング引数を自分のコードから外す作業をしておりました。だから大丈夫だろう、と一度は思いました。ところが公式の Text watermark ページには、もう一行こう添えてあります。フレームワークやクライアントライブラリが、代わりにこれらを設定している場合があります。 自分が書いた覚えがなくても、送られている可能性はあるのです。
最初にお伝えしたいのは、多くの方は何もしなくてよいことです
Text watermark のページは、透かしが出力の意味・品質・読みやすさを変えず、トークンも隠し文字も足さず、利用者や組織の情報も持たないと説明しています。リクエストや応答の処理を変える必要もありません。
手を入れる必要があるのは、「出力に透かしが付いていること」を当てにしている場合だけです。たとえば、社内の決まりで生成した文章の出どころを後から確かめられるようにしておきたい、配信物に来歴の手がかりを残したい、といった事情がある方です。私の場合は、アプリのストア掲載文の多言語化で下書きに Claude を使っており、どの文が Claude を通ったかを後から辿れる状態にしておきたい、という動機でした。
判断の順番を表にしておきます。
| 状況 | やること |
|---|---|
| 透かしを当てにしていない | 何もしなくてよい(公式も変更不要と明記) |
| 当てにしていて、対象モデルを使い、3つのどれかを送っている | 送っている引数を外す |
| 当てにしていて、送っているか分からない | 下の方法で送信ボディを1回記録してから決める |
| API バージョン 2026-10-21 で送っている | 3つは既定値でも 400 になるため、そもそも送れていない |
Sampling settings の節で対象として挙がっているのは、Opus 4.6・Sonnet 4.6・Opus 4.5・Sonnet 4.5・Haiku 4.5、それに申請制の Opus 3 です。Sonnet 4.6 については 11 月 3 日のリリースノートで同じ注意がすでに出ていました。なお Sonnet 4.5 は 11 月 30 日に提供が終わるので、残りは 13 日です。移行先のモデルでも、この節の対象かどうかをもう一度確かめておくと安心できます。
grep では「送ったもの」までは見えません
10 月にサンプリング引数を外したときは、ソースコードを検索して temperature= の行を消していきました。その手順はSDK を上げた途端に temperature が 400 になる前に、呼び出し箇所を洗いましたに書き残しています。
ただ、検索で分かるのは「自分が書いたもの」までです。LangChain のようなフレームワーク、社内の共通ラッパー、設定ファイルから値を読み込む仕組み——こうした層が既定値を差し込むと、ソースには何も書かれていないまま、送信ボディには数字が入ります。公式がわざわざ「リクエストボディを確認して」と書いているのは、このずれを指しているのだと思います。
そこで、書いたコードではなく、送った中身で確かめることにしました。
Python SDK — httpx のイベントフックで1行だけ記録する
公式の Python SDK は http_client に httpx のクライアントを渡せます。送信前に呼ばれるフックを挟み、Messages API への送信から3つのキーだけを取り出して表示します。プロンプトの本文は出さないので、ログに顧客の文章が残る心配もありません。
import json
import anthropic
import httpx
SAMPLING_KEYS = ("temperature", "top_p", "top_k")
def log_sampling(request: httpx.Request) -> None:
# Messages API への送信だけを見る(count_tokens やバッチは別に確かめる)
if not request.url.path.endswith("/v1/messages"):
return
try:
body = json.loads(request.content or b"{}")
except (ValueError, httpx.RequestNotRead):
print("[sampling] 本文を読めない送信がありました")
return
found = {k: body[k] for k in SAMPLING_KEYS if k in body}
print(f"[sampling] model={body.get('model')} {found or 'なし'}")
# API キーは環境変数 ANTHROPIC_API_KEY から読ませる
client = anthropic.Anthropic(
http_client=httpx.Client(event_hooks={"request": [log_sampling]}),
)
client.messages.create(
model="claude-haiku-4-5-20251001",
max_tokens=64,
messages=[{"role": "user", "content": "ひと言だけ返してください"}],
)このフックを、フレームワークが内部で使っているクライアントに渡せるなら、そちらにも同じものを付けます。渡せない場合は、そのフレームワークの設定項目で3つの既定値を確かめるのが次善の策です。
値を表示するだけにしているのは、フックの中で書き換えると、どこで値が入ったのかが分からなくなるからです。見つけたら、差し込んでいる層の設定を直します。
TypeScript SDK — fetch を包んで同じことをする
TypeScript SDK は fetch を差し替えられます。考え方は Python と同じで、本文から3つのキーだけを読みます。
import Anthropic from "@anthropic-ai/sdk";
const KEYS = ["temperature", "top_p", "top_k"] as const;
const client = new Anthropic({
fetch: async (url, init) => {
if (String(url).endsWith("/v1/messages") && typeof init?.body === "string") {
const body = JSON.parse(init.body);
const found = KEYS.filter((k) => k in body).map((k) => `${k}=${body[k]}`);
console.log(`[sampling] model=${body.model} ${found.join(" ") || "なし"}`);
}
return fetch(url, init);
},
});どちらも、本番に常設するものではありません。透かしを当てにしている処理を1回ずつ通し、ログを読んだら外します。
試してみて決めた線引き
フックを付けて、透かしを残したい下書き生成の処理を1回ずつ流しました。私の構成では3つのキーはどれも出てきませんでしたが、これは 10 月に外していたからにすぎません。フレームワークを挟んでいる方は、結果が違ってもおかしくないと思います。
一方で、気づいたこともありました。透かしを当てにする処理と、そうでない処理が、同じクライアントを共有していたのです。前者では引数を送らない、後者では自由に使う——この区別がコードの上で見えないと、誰かが善意で temperature を足した日に、静かに前提が崩れます。
いまは、透かしを当てにする呼び出しだけを1つの関数にまとめ、その関数の中では3つの引数を受け取らないようにしています。当てにする処理は、引数を送れない形にしておく。 守るべき前提は、注意ではなく形で残すほうが長持ちするようです。
透かしと、画像などに付く来歴メタデータの違いについては、透かし入りの生成テキストを、アプリの配信物に載せる前に決めておくことで整理しています。Sonnet 4.5 の呼び出し元を数える方法はSonnet 4.5 の退役まで 43 日 — 呼び出し元は grep ではなく、Usage の CSV から数えましたにあります。
次にやること
透かしを当てにしている処理が1つでもあるなら、上のフックをその処理にだけ付けて、1回だけ流してみていただければと思います。ログに「なし」と出れば、今日の告知で変えることはありません。数字が出たら、その値を差し込んでいる層を一つずつ辿ります。
私も、ストア掲載文の下書きを作る処理から始めました。送ったものを自分の目で一度見ておくと、次にリリースノートが更新されたときも落ち着いて読めると感じています。