すべての記事
出力は同じ、道筋は違う — エージェントの軌跡を不変条件で守る
既定モデルが入れ替わっても最終出力は正しいまま、ツール呼び出しの道筋だけが静かに変わることがあります。実行トレースを記録し、不変条件で機械的にアサートする軌跡回帰ハーネスを実装コードと実測値で整理しました。
「ゲートに合格した原稿」と「公開された原稿」は同じものか — 検証と公開のあいだに開く隙間
無人パイプラインでは、品質ゲートが検証したファイルと実際に公開されるファイルが別物になる隙間があります。内容のダイジェストを束ねた合格証を発行し、公開直前に照合するTOCTOU対策の設計を、実装コード、導入前後の実測、4段階の導入手順、運用で気づいた落とし穴とともにまとめました。
RAG が自信たっぷりに間違え始めたとき — 検索の取りこぼしを接地率で計測する運用メモ
Claude API の RAG で、回答は流暢なのに事実がずれ始める。多くの場合、原因は検索側で答えを含む文書を取りこぼすサイレントなリコール低下です。接地率と検索ヒット率を計測し、段階的に立て直した運用メモを、動くコードと実数値付きで残します。
20万トークンの崖で夜間バッチの請求が跳ねた — count_tokens プリフライトで長コンテキスト単価を避ける
Sonnet 5 のネイティブ1Mコンテキストは、入力が20万トークンを超えた瞬間にリクエスト全体が長コンテキスト単価へ切り替わります。無人バッチで請求が静かに倍増する崖を、課金対象外の count_tokens プリフライトで手前に止めた実装を、Python と TypeScript の動くコードで記録します。
Claude Code と Cursor の使い分け — 他人のベンチマークではなく自分の環境で測る
Claude Code と Cursor を、設計思想・エージェント機能・課金の形という3点で整理しました。出所の曖昧な「何%高速」という数字に頼らず、自分のリポジトリで所要時間とトークン消費を実測する手順、そして両方を併用するときの境界の引き方までまとめています。
Claudeでクレジットカードが拒否されるとき — 止めた相手を一つに絞る手順
Claude Pro / Max の登録や更新でカードが拒否されるとき、止めているのは発行元の銀行か、Stripe か、Anthropic か。決済を受ける側に届く拒否コードを手がかりに、海外決済ブロック・3Dセキュア・郵便番号の不一致を順番に切り分ける手順をまとめました。
Claude でカードが拒否されたときの完全対処ガイド — 原因別チェックリストと代替手段
Claude Pro/Max/APIの決済でカードが拒否される原因を、銀行側・Stripe側・Anthropic側の3層に分けて解説します。国際カード・3Dセキュア・VCNの落とし穴と、法人カード・Wise・Apple Payへの切り替え手順まで、実運用で詰まりやすいポイントをまとめました。
自コードの Required Reason API 申告漏れを Claude Code で棚卸しする
PrivacyInfo.xcprivacy の理由コードは、依存ライブラリだけでなく自分のコードにも必要です。個人開発の壁紙アプリで申告漏れを見つけた経験から、Swift ソースを走査して該当 API と理由コードを突き合わせる Claude Code ワークフローをまとめます。
無人エージェントの挙動変更を、フィーチャーフラグで少しずつ試す設計
無人で走るエージェントのプロンプトや挙動を一度に全変更すると、劣化が朝まで見えません。フィーチャーフラグで一部の実行にだけ新挙動を割り当て、品質を見てから広げる設計と、決定論的バケット・自動ロールバック・監査証跡の実装を紹介します。
MCP コネクタを申請・無人運用に回す前に、各ツールを契約テストで確かめる
手元で動いた MCP コネクタをそのまま無人ジョブに繋ぐと、応答形状の誤読や書き込みの二重発火で静かに壊れます。ツール記述・応答契約・冪等性・レイテンシを機械検証する小さなハーネスの作り方を、実測値とともにまとめました。
夜間のコネクタが二晩落ちても気づけなかった — 可観測性 public beta を機に、個人運用に計器を付けた記録
コネクタ可観測性がpublic betaになった週、個人運用の自分にはエラーもレイテンシも見えていないと気づきました。MCPコネクタ呼び出しを包む薄いラッパーの実装、週次で振り返る小さな集計、数字がしきい値の決め方を変えた経緯まで、夜間ジョブに計器を付けた記録です。
4サイト分のClaude費用が一つの請求に混ざる — ワークスペース単位で支出を割り当て、絞るパイプラインを見極める
複数プロジェクトのClaude API費用が一つの組織請求に合算されて判断を誤る問題を、Cost Report / Usage Report の group_by でワークスペース別に割り当てて解く実装メモです。防御的パース・showback表・費用対効果での選別まで扱います。