技術文書RAGの検索品質・ハルシネーション対策・コストを実測する

WebSockets を使用して Claude API と連携し、複数ユーザーがリアルタイムで協働できるライティングツールの実装方法を解説。ユーザー間の同期・競合処理や Claude との非同期通信パターンを具体的に紹介。

約3年ぶりのAPIバージョン 2026-10-21 で `temperature` / `top_p` / `top_k` が既定値でも400エラーとなり、Python 2.0.0 など新メジャーSDKは既定でこの版を送信。認証ヘッダの `Authorization: Bearer` 化、MessageParam の型変更も含め、Python SDK 新旧の差分を MockTransport で実測。上限なしの依存指定がもたらす httpx2 移行リスクにも言及しており、Claude API 利用中の開発者向けの移行チェック事例。

記憶ゼロで定期起動される Claude Agent の事業運営実験で、人間の作業待ちによる「確認だけ」の起動 13 回がコストを押し上げた事例。休止ファイル (NEXT_RUN) による起動時刻指定、予算 20% を終了処理用に残すルール、作業の重さに応じたモデル・スクリプトの使い分けで、1日の消費を $8.15 から $2.69 まで削減。自律 Agent の運用コストを設計する開発者向け。

Next.js・Supabase・Claude 製のメルマガ自動生成サービスにおける、材料にない数字や日付の混入を送信前にコードで止める4段階の検査設計の解説。zod スキーマによる構造化出力、段ごとの `source_url` と材料 URL の完全一致照合、機械点検を先行させる送信前チェック、本文ハッシュによる再点検検知など、実装コード付きで紹介。Claude API で事実性が求められる出力を扱う開発者向け。