すべての記事
予告された課金変更が直前で撤回されたとき、設定を一行も書き換えずに済ませる
発効するはずだった課金変更が当日に撤回される——そんな事態でも設定を一行も書き換えずに済ませるための設計です。プラットフォームの挙動を一箇所のフラグに集約する方法、適用時の月額差分を実測から先に出す手順、撤回を「保留のまま」にする考え方、先回り改修が招く事故を記録します。
デプロイ直後に「500」と出るのに curl は 200 を返す — Next.js のエラー境界が ChunkLoadError を取り違えていた話
本番のNext.js記事ページがブラウザで「500 Internal Server Error」と表示されるのにcurlでは200。原因はサーバーではなくChunkLoadErrorとerror.tsxの誤表示でした。切り分け手順と自動リロードを組み込んだ修正を記録します。
Claude API のマルチテナント SaaS で「請求が合わない」を消す — テナント分離とコスト帰属の実装メモ
Claude API の SaaS をマルチテナント化したとき最初に壊れるのはコスト帳尻です。計測の単一窓口・原子的カウンター・Anthropic 請求との突合・テナント分離の敵対的検証まで、本番で動く TypeScript と運用判断を実装メモとしてまとめます。
自律エージェントの判断根拠を台帳に残す — 「なぜそうした」を後から説明できる設計
自律エージェントが本番デプロイやファイル削除のような後戻りしづらいアクションを取るとき、採用案・却下案・前提を構造化して台帳に残す設計をまとめました。structured output と追記専用ログ、影響度による線引きまで実装します。
Claudeの構造化出力を本番で信頼する — 検証ゲートと修復ループの設計
Claude APIの構造化出力が「たまに」壊れる本番環境で、tool useによる強制・スキーマ検証ゲート・一度だけの修復ループ・劣化フォールバックを組み合わせ、壊れたJSONを運用から消すための設計をコード付きで解説します。
長時間エージェントのトークン肥大を context editing と memory tool で抑える
ツール結果が積み上がって入力トークンが膨らむ長時間エージェント向けに、context editing と memory tool を併用し、削減量を count_tokens で実測する手順を、自前バックエンド実装つきでまとめます。
Claude Code の大規模リファクタを 1 コミット単位で巻き戻せる状態に保つ — チェックポイント設計とロールバック検知の実装メモ
Claude Code に大規模リファクタを任せると速さの裏でレビュー不能な巨大 diff が積み上がります。チェックポイントをマニフェストで管理し、コミット粒度を pre-push で機械的に強制し、ロールバック判断を Observability に紐づける——個人開発と受託で固めてきた実装メモです。
予約実行が始まる前に、使うモデルが本当に応答するか1回だけ確かめる
設定したモデルが、夜間ジョブが動き出す前に消えていることがあります。引退・撤回・地域制限の3つを起動時の1回のプローブで見分け、適格なモデルへ実行設定を自動で書き換える設計を TypeScript の動くコードでまとめました。
Claude API の PII マスキングは台帳運用で決まる — 復元・暗号化・漏洩率の本番設計メモ
Claude APIへ送る前のPIIマスキングで本当に難しいのは検出ではなく、復元用トークン台帳の運用です。正規表現とHaikuのNERによる2層検出、暗号化した共有ストアとしての台帳実装、ゴールデンデータセットによる漏洩率の毎日計測まで、本番で踏んだ落とし穴を含めて動くコード付きで整理します。
課金変更2日目 — headless 工程の実コストが事前見積もりからどれだけズレたか
6月15日の課金変更で headless 実行が月次クレジットに切り替わりました。発効2日目に工程別の実コストを集計したところ、ある工程だけ見積もりの約2倍。計測の仕組みと、1工程をサブスク枠へ戻した判断を記録します。
課金変更が発効した日に、headless 実行のコストを工程ごとに計測する仕組みを入れた
6月15日の課金変更で headless 実行とエージェント委譲が月次クレジット制になりました。どの工程がいくら使っているかを response.usage から工程タグ単位で記録し、日次で円換算レポートを出す計測レイヤーの実装を共有します。
Anthropic API のベータヘッダを一元管理し、機能の引退でバッチを止めない設計
anthropic-beta ヘッダを散らばったまま使うと、ベータ機能の引退や GA 昇格でバッチ全体が 400 で落ちます。ケイパビリティ登録簿と起動時プリフライトで、機能の世代交代に耐える小さな抽象化を実装します。