接続が切れた瞬間、その投稿は通ったのか — 無人パイプラインで MCP 書き込みを二重実行せずにやり直す
接続断で中断した MCP の書き込みツール呼び出しは、サーバー側で実行されたかどうか分かりません。素朴な再試行が二重投稿を生む理由と、冪等キーと照合読み取りで安全にやり直すラッパーの実装を、無人パイプラインの実例とともにまとめました。
ストリーミング応答のCPUと取りこぼしを実測して長時間バッチを安定させる
夜間に走らせた長時間バッチが、朝には半分しか終わっていない。原因はCPU張り付きとストリームの中断でした。streamのCPU・スループットを実測し、中断から再開する監視ラッパーの実装を紹介します。
自己修復ループに「諦める条件」を設計する — エラーを4分類して再試行予算を割り当てる
LLMの自己修復ループは「直し続ければいつか通る」という幻想で破綻します。エラーを4つに分類し、クラスごとに再試行予算を引く設計を、動くTypeScriptと実測コストで解説します。
同じモデル名で挙動が変わったとき — 無人パイプラインに起動時カナリアを置いて差分を捕まえる
Opus クラスの無言の上方更新で出力が変わっても、無人の自動投稿は気づきません。起動時に小さなカナリアを走らせ、挙動の差分を捕まえてバッチを止める設計を、実測値とともに紹介します。
API リクエスト1本でリモート MCP サーバーに直接つなぐ — Messages API の MCP コネクタ実装メモ
ローカルに MCP クライアントを立てずに、Messages API の mcp_servers と mcp_toolset だけでリモート MCP サーバーのツールを呼ぶ実装をまとめました。allowlist/denylist 設計、レスポンス処理、無人運用での落とし穴まで。
上限が倍になった日に決めたこと — 共有APIキーで定期ジョブを束ねる余白予算の設計
レート上限が倍になっても間隔を詰めなかった理由と、共有 API キーで複数の定期ジョブを束ねる『余白予算』の設計を、ヘッダー計測と実コードでまとめました。
思考が常時オンのモデルに移すと、プレフィルが静かに効かなくなる — Fable 5 でストリーミングとトークン予算を直した記録
Fable 5 は思考が常時オンです。プレフィルが使えない・ストリーミングの先頭ブロックがテキストではない・max_tokens に思考分の余白が要る、という三つの前提崩れを、自分の自動投稿パイプラインで直した実装メモです。
同じモデルが環境ごとに別名になる問題 — Claude をマルチプロバイダーで呼ぶ識別子リゾルバの設計
Fable 5 が API・Bedrock・Vertex で同時に使えるようになった結果、同じモデルが環境ごとに別の識別子を持つようになりました。ハードコードした model 文字列が移行を阻む問題を、論理モデル名・能力フラグ・起動時検証を備えた識別子リゾルバで畳み直す実装を整理します。
Claude Files API のファイルが知らぬ間に溜まる — 内容ハッシュ台帳で重複を止め、孤児を回収する
自動パイプラインで Files API を使うと、同じファイルが何度もアップロードされ孤児ファイルが静かに溜まります。内容ハッシュ台帳での重複排除と、参照されなくなったファイルの GC 設計を実装例つきで解説します。
Claude API のコスト計算が請求と合わないとき — usage の4トークンバケットを正しく会計する
プロンプトキャッシュを有効にすると、自前のコスト集計とコンソールの請求額がずれます。usage が返す4つのトークンバケットを重み付きで会計し、突合できる台帳を組む方法をまとめました。
service_tier で優先枠をユーザー応答だけに振り向ける
Priority Tier を契約しているのにピーク時だけユーザー向け応答が遅くなる——その原因を service_tier の auto と standard_only の挙動から切り分け、背景ジョブを優先枠から隔離する構成を、自動運用の実例とともにまとめました。
effort パラメータを工程ごとに振り分けて Claude の出力コストと待ち時間を整える
Claude API の effort パラメータは思考・本文・ツール呼び出しを含む出力トークン全体を制御します。一律 high をやめ、工程ごとに段階配分する実装と動的ルーターを、個人開発の自動運用での実測とともに解説します。