すべての記事
Anthropic API のベータヘッダを一元管理し、機能の引退でバッチを止めない設計
anthropic-beta ヘッダを散らばったまま使うと、ベータ機能の引退や GA 昇格でバッチ全体が 400 で落ちます。ケイパビリティ登録簿と起動時プリフライトで、機能の世代交代に耐える小さな抽象化を実装します。
モデルが予告なく使えなくなる日に備える — 引退・撤回・過負荷を一つのステートマシンで扱うルーター設計
あるモデルが、技術的な障害ではなく外部都合で短時間のうちに使えなくなる。引退・撤回・一時的な過負荷という三種の「使えない」を一つの可用性ステートマシンで扱い、自動運用を止めないルーターを TypeScript と Python の動くコードで設計します。
Claude に最新ページを直接読ませる — web_fetch ツールの実装と落とし穴
Claude API の web_fetch ツールで、公式ページや PDF の本文をそのままコンテキストに取り込む実装手順です。URL を勝手に作らせない検証の仕組み、トークンを溶かさない設定、200 で返るエラーの処理まで、個人開発の自動運用で実際に踏んだ判断を共有します。
Claude Agent SDK のツールを冪等にする — 二重実行を止める冪等性キーと Outbox の実装メモ
Claude Agent SDK のリトライやセッション再開で決済を二重処理する事故を防ぐ実装メモ。決定的な冪等性キー・Outbox・軽量ラッパーの3パターンを、動くコードと運用メトリクスつきで設計します。
応答したモデルを記録する — headless パイプラインでモデル実体とコストを突き合わせる
API 応答が返す model フィールドと usage を毎回記録し、要求モデルと実際に応答したモデルのズレを検出する設計です。6/15 の usage credits 移行に向けたモデル別コスト照合まで実装します。
Claude の Dreaming を長期稼働エージェントのメモリ整理に組み込む
Managed Agents の Dreaming は過去セッションを点検してメモリを再構成する自己改善機構です。Harvey や Wisedocs の公開数値を読み解き、Anthropic SDK で自前のメモリ整理ループを組む完全なコードと、本番運用での落とし穴までをまとめました。
6/15 の claude-sonnet-4・claude-opus-4 引退に備えて、本番のモデルIDを棚卸しする
6月15日に claude-sonnet-4 と claude-opus-4 が API から引退します。直書きされたモデルIDを引退前に洗い出し、出力パリティを検証し、別名レイヤーとフォールバックで安全に切り替えるまでの実装手順をまとめました。
Claude Vision API 実装パターン — 画像解析・PDF 処理・OCR を本番品質で動かすまで
Claude API のビジョン機能を本番投入するための実装パターンをまとめました。Base64・URL・Files API の使い分け、ネイティブ PDF 処理、Tool Use による壊れない構造化抽出、Batch API でのコスト削減、エラー対処まで動くコードで解説します。
Claude API Python 上級クックブック:本番運用で効く実践パターン集
Claude APIをPythonで本番運用するときに効く実装パターンを20個に厳選したコードレシピ集です。リトライを含む堅牢な呼び出し基盤、非同期・並列処理、コスト最適化、テストとデバッグ、監視と運用までを段階的に整理し、どこから手をつけるかの優先順位も併せて示します。
Managed Agents にスケジュールデプロイと vault が加わったので、自前 cron 運用との住み分けを決めた記録
6月12日の更新で Claude Managed Agents にスケジュールデプロイ・vault 環境変数・セッションスレッド Webhook が加わりました。自前の cron と平文クレデンシャル運用から何を移し、何を残すか。冪等性を軸にした判断基準と受け口の実装を残します。
「続きを書いてください」をやめる — Claude Fable 5 の 128k 出力で長文レポート生成を一括化した実装記録
数万字の月次レポートを生成するたび、出力上限で切れて「続きから」と投げ直していた運用を、Claude Fable 5 の 128k 出力で一括化しました。ストリーミングで受け切る実装、切断からの再開設計、分割生成との費用比較を実測ベースで残します。
Claude API の Code Execution ツールに月次の売上CSV集計を任せる — Files API 連携から課金の落とし穴まで
月末に形式の違う売上CSVを突き合わせる作業を、Claude API の Code Execution ツールに任せた実装をまとめます。Files API 連携、コンテナ再利用、5分最小課金やファイルプリロード課金などの注意点を実例ベースで扱います。