非ストリーミングの長い応答が10分の壁で黙って二重課金されていた — SDK既定のタイムアウトと自動リトライを設計し直す
Anthropic SDK の既定タイムアウト10分と自動リトライ2回が、長い非ストリーミング応答を裏で二重に走らせて課金することがあります。発生の仕組みと、ストリーミング切替・明示的な timeout/max_retries・ローカル台帳で止める実装を、実測値とともにまとめました。
Claude Code SDK で本番品質の自律エージェントを作る7つの設計原則 — スタミナ・エラー回復・コスト管理の実装
自律エージェントを「動かす」ことと「本番品質で動かし続ける」ことの間には大きな溝があります。ループ深度の上限、2層のタイムアウト、重複ツール呼び出しの検知、エージェントレベルのコスト予算、エラーの回復可否分類、構造化ログ、グレースフルデグレードの7原則を実装パターンで解説します。
Claude API Pythonクライアントで最初によく出るエラー：初心者が詰まる7つのポイントと解決コード
Claude API Python SDKを使い始めた際に遭遇しやすい7つのエラーを、原因と修正コードをセットで解説。AuthenticationError・RateLimitError・BadRequestError・レスポンス解析ミスなど、初心者が詰まりやすいポイントを体系的にまとめました。
Claude Code SDK でカスタム自律エージェントを実装する — 公式 CLI を超えた独自ループ設計の実践
Claude Code SDK の内部構造を理解し、公式 CLI では制御しきれない自律エージェントループを Python/TypeScript で実装します。ツール許可・エラー回復・ストリーミングに加え、課金変更後のコスト計測とモデル棚卸しまで、実運用で使っているパターンを共有します。
Claude API × Kotlin Multiplatform 実装ガイド — iOS/Android共通AIアシスタント機能を本番で動かす
Kotlin Multiplatform（KMP）でClaude APIを統合し、iOS・Android両方でAIアシスタント機能を本番品質に仕上げるまでの実装記録です。SSE終端の落とし穴・エラーイベント処理・expect/actualの整合性・テスト戦略までを扱います。
Claude SDK Tool Runner でエージェントループを自動化する
ツール呼び出しの検出・実行・返却という定型ループを自前で書かずに済む、Claude SDKのTool Runnerを解説します。Tool Helpersによるツール定義、エージェントループの構築、自動コンパクションでのコンテキスト管理、strict指定による入力スキーマの厳密検証までコード例で確認します。
Claude API エラーハンドリングとリトライ戦略
Claude APIのHTTPステータスコードとエラータイプ、レート制限の仕組みを整理し、本番で安定した連携を実現するリトライ戦略を解説します。SDKの自動リトライ機能、サーキットブレーカーパターンの実装、ストリーミング時のエラー処理まで、堅牢な統合のための実践をまとめました。
Claude API クイックスタート — 最初のAPI呼び出しまで5分
Claude APIの基本的な使い方を解説。APIキーの取得からPython/TypeScript SDKでの最初のリクエスト、エラーハンドリングとコストの目安まで、5分で始めるためのクイックスタートです。