Claude の Message Batches API で大量リクエストを半額・非同期処理する実装手順 — ポーリングと custom_id 突合の3つのハマりどころ

OpenRouter の :free 無料モデルは 2026 年時点で Qwen3・Llama・Gemma・DeepSeek など 5 モデル以上が実用レベルに達した。コーディング・推論・マルチモーダル処理など用途別に最適モデルが異なり、レート制限と文脈長を把握すれば月 $0 でエージェント運用が現実的。各モデルの強弱・推奨ユースケース・API 呼び出し例を詳解。

はてなブックマークと Zenn から毎日40件を集め、Claude Haiku で AI・開発関連の記事のみを選別して、毎晩 Telegram に配信するシステムを構築。サーバーレスで GitHub Actions を使用し、30日の API 利用料は0.28ドル。選別のみを LLM に任せることで、生成コストを削減しつつ、重複排除や JSON パース失敗への対策を実装。

Claude Code の ANTHROPIC_BASE_URL を OpenRouter に差し替えることで、無料の LLM モデル（Llama、Gemma 等）をコード補完・レビュー・テスト生成に活用できる。モデル切り替えエイリアス、プロジェクト設定ファイル、コスト上限管理スクリプトなど 5 パターンの実装方法を解説。

エージェント実行中にtools配列を変更するとプロンプトキャッシュが無効になり、数万トークンが再課金される問題がある。Anthropicが導入した「mid-conversation tool changes」機能を使うと、tools配列を固定のまま、tool_addition/tool_removalブロックで途中から特定ツールの表示/非表示を制御でき、キャッシュを温存できる。