Spring Boot から公式 Java SDK で Claude API を呼ぶ最小実装

非エンジニアが Claude に動画を理解させるため、ffmpeg と Whisper を組み合わせて静止画フレーム・音声転写・タイムスタンプをセットで渡すオープンソースツールを開発。タイムラプスをリアルタイム映像と誤認する問題を、AI の改善ではなく物理的な妥当性チェックという判断材料の充実で解決した事例。

前回構築した VPC 内の隔離環境で、複数の AI（Gemini・Claude・Grok）をラウンド制で議論させる「密室会議システム」を実装。会話は restricted VIP 内で完結し外部漏洩なし。ただし Claude を Vertex AI 経由で追加しようとしたら個人アカウントの壁により申請が自動却下され、代わりに Grok で運用する結果に。

Claude などの AI サービスの料金体系における 3 つの一般的な誤解を、実際の利用ログと公式情報から解析する。クレジット表示と実際の通貨換算の非直感性、サブスクリプション プラン vs 従量課金の本当の違い、トークン圧縮による実コスト削減など、ユーザーが実際に何に幾ら払っているかを理解することで、AI の使い方そのものが変わる。

Claude API を初めて使う個人開発者向けの実装ガイド。モデル選定（Sonnet 5 推奨）・API キー取得・Python/Node.js での最小動作コード・月額コスト試算（軽い利用なら約 1,000 円）をまとめた。ChatGPT API との比較では、Claude のコーディング精度（SWE-bench 80.8%）と長文処理能力（1M トークンコンテキスト）、低ハルシネーション率が強み。