Claudeモデルの選び方
Opus/Sonnet/Haikuのトレードオフと、推測せずに選ぶ方法。
トークン、コンテキスト & 料金
トークンを正しく数える、max_tokens vs コンテキストウィンドウ、そしてコストの見積もり。
初めての API 呼び出し
SDK をインストールし、認証して、Python・TypeScript・cURL で Claude への実際の呼び出しを行う。
API Version 2026-10-21 — 3年ぶりの破壊的変更を伴うバージョン
Claude の anthropic-version ヘッダーが 2023 年以来初めて変わりました。何が壊れるのか、なぜパッケージマネージャーが採用時期を決めるのか、そして正確なアップグレード手順。
ストリーミング & マルチターン会話
レスポンスをストリーミングし、ステートレスな API で履歴を管理する。
ツールの利用 / 関数呼び出し
ツールを定義し、エージェント型ループを実行し、結果を処理する——400 を引き起こす3つのメッセージ形状ルール、そして最新の Claude モデルで tool_choice の "any" と "tool" がエラーになるようになった理由も含めて。
コード実行ツール — サンドボックスによる Bash、ファイル、Python
Anthropic のサーバー側サンドボックスは、Claude が Bash 実行、ファイル編集、Python 実行を行える環境を提供する — 5 GiB の RAM、30 日間のコンテナ再利用、月 1,550 時間の無料枠付き。3 つのツールバージョンとそれぞれで追加される機能、無料になる条件、誰も文書化していないファイルキャプチャの落とし穴。
ビジョン、PDF & ファイル入力
画像やドキュメントを送り、file_id でアップロードを再利用する。
構造化出力
プロンプトで祈るのではなく、信頼できるスキーマ準拠の JSON を得る。
拡張思考 & エフォート
適応的な推論とエフォート制御 — ワークロードに応じて深さを選ぶ。
effort のチューニング：5 段階、モデル別デフォルト、キャッシュの罠
2026 年 7 月の effort パラメータには low・medium・high・xhigh・max の 5 段階があり、トップレベルではなく output_config の中に置きます。思考だけでなくツール呼び出しにも影響し、会話の途中で変更するとプロンプトキャッシュが無効になり、推奨される出発点もモデルごとに異なります。実践的なチューニングガイドです。
advisorツール:Sonnetが手を動かし、Fableが考える
アドバイザーサーバーツール(ベータ advisor-tool-2026-03-01)は、高速な実行モデルがターンの途中でより強力なモデルに相談することを可能にする。全フィールドリファレンス、統合者の大半が見落とすトークン集計の罠、モデルペアリング表、そしてAnthropicが本番で提供する実プロンプトを網羅。
タスク予算 — エージェントを優雅に終わらせる助言的トークン上限
2026 年 3 月の Messages API ベータは、エージェントループ全体 — 思考、ツール呼び出し、ツール結果、出力 — に対するトークン予算を Claude に与え、長時間実行エージェントが暴走せずに自己調整してきれいに締めくくれるようにします。カウントダウンの仕組み、強制ではなく助言的である理由、拒否のような挙動を招かないサイズの決め方。
プロンプトキャッシュとコスト最適化
安定したプロンプトのプレフィックスを再利用してコストとレイテンシを削減する——そしてそれを壊す落とし穴。
キャッシュ診断 — キャッシュがミスした理由を正確に突き止める
cache_read_input_tokens がゼロになる理由をもう推測しなくていい。プロンプトのどの部分が、何トークン分ずれたのかを API が教えてくれる。
Message Batches — 50% オフの非同期ジョブ
一括処理を非同期の Batches API に移してコストを半減させ、スループットを引き上げる — つまずきやすい落とし穴も含めて。
会話途中のシステムメッセージ
プロンプトキャッシュを壊さずに長時間のエージェントセッションを操舵する — ユーザーターンの後に追加できる新しい system ロール。
会話途中のツール変更
プロンプトキャッシュを無効化せずに、ターン間でツールを追加・引退させる — 長時間のエージェントセッションにおける最大の隠れた税を修正する Opus 5 ベータ。
API でエージェントを構築する
単一呼び出し vs ワークフロー vs カスタムエージェント — 判断テストとループ設計。
Managed Agents
Anthropic ホスト型のエージェントループ：エージェント vs セッション、環境、メモリ、Vault、スケジュールされたデプロイメント（cron）。
Managed Agents メモリストア
2026年7月ベータ — Managed Agents サンドボックスにマウントされる、バージョニング・監査証跡・秘匿化を備えたサーバーサイドの永続メモリ。
Managed Agents セッション予算
2026年8月ベータ — Managed Agents セッションのハード USD 上限。パブリックリスト料金で強制、budget_reached 停止理由、1リクエスト分のオーバーシュート、そして一時停止と再開のモデル。
Managed Agents のドメイン制限
2026 年 8 月 26 日のベータ — Managed Agents 内の web_search と web_fetch における allowed_domains、blocked_domains、max_content_tokens、user_location。書式ルール、マルチエージェントのセマンティクス、セッション途中の更新、url_not_allowed エラー。
Cowork & エージェントチーム
エージェント型のデスクトップワークスペースと、製品としてのマルチエージェント協調。
MCPとツールへの接続
Messages APIから直接リモートMCPサーバーを呼び出す — リクエストの形、許可リストと拒否リスト、遅延読み込み、そして本番で効いてくる制限。
MCP 2026-07-28: ステートレス仕様
MCPローンチ以降で最大の改訂。セッションが消え、あらゆるリクエストが自己記述型となり、ロードバランサ配下のどのサーバーインスタンスでも任意の呼び出しに応答できる。2026年7月28日に実際に何が変わったのか、既存のサーバーを壊さずに移行する方法。
MCP Apps: ツール呼び出しの中のインタラクティブUI
MCP Apps（SEP-1865）は、MCPサーバがHTML UIを配信し、クライアントがそれをサンドボックス化されたiframeの中でレンダリングできるようにする — すべてのアクションは依然として標準のJSON-RPC監査パスを通る。仕様が実際に何を述べているか、これで何を作るべきか、そして何を作ることを拒否すべきか。
MCP Tasks:セッションなしで長時間実行する仕事
2026-07-28のステートレスMCP仕様がセッションを廃止した — では、20分のCIジョブ、バッチインポート、人間の承認ゲートをどうモデル化するのか?公式のTasks拡張(SEP-2663)で解決する。完全なライフサイクル、ワイヤープロトコル、旧実験版Tasks APIからの移行、そして本番で実際に機能するポーリング/通知パターン。
Playwright MCP:深く実践的なガイド(2026)
Microsoft の Playwright MCP は今や世界No.1 の MCP サーバー — GitHub や Figma を上回る。ほとんど誰も教えない部分:デフォルトのアクセシビリティスナップショットモードは vision より速いだけでなく、まったく別の自動化パラダイムだ。プロファイル、オプトインの機能パック、あなたの実 Chrome にアタッチするブラウザ拡張モード、Playwright-as-a-Skill とのトークンコスト対決、そして越えてはならないセキュリティの一線。
安全性、拒否とフォールバック
拒否を優雅に処理し、分類器によるブロックと区別する。
サーバー側フォールバックとフォールバッククレジット
Fable 5 / Opus 5 の拒否を1回のAPI呼び出しで通常の回答に変える Opus 5 ベータ機能 — さらに、リトライ時にプロンプトキャッシュを二重支払いさせないクレジットトークン。
エラー、レート制限 & 信頼性
エラーマップ、バックオフ付きリトライ、レート制限のティア、モデル移行。
メモリとコンテキスト編集
エージェントに永続的なメモリと自動整理されるコンテキストを与える — クライアント側の memory tool と、古いツール結果を削除して長時間の実行を生き延びるコンテキスト編集。
会話のコンパクション — 履歴をサーバー側で要約して続行する
Messages API は会話を 1 つの署名付きブロックに要約し、置き換えた元のメッセージの代わりに送り返せます。4 つの方式（オンデマンド、keep-tail、バックグラウンド、しきい値）、差し替えのルール、HTTP 200 のまま静かに失敗する 2 つのミス、そして要約が決して運べないもの。
ツール検索と遅延読み込み
コンテキストを肥大化させずに数千のツールへスケールする方法。defer_loading とツール検索ツールの実際の動作、それが引き起こす5種類の 400 エラー、そしてリクエストボディが小さくならない理由を解説します。
Message Threads — 新しいターンだけを送る
Messages API は会話をサーバー側に保持でき、各ターンで新しいメッセージだけを送れば済みます。実際に節約できるもの(バイト数とレイテンシであり、トークンではない)、リリース前に必ず作るべきリプレイ経路、3 つのフィールドグループ、そして 4 ブレークポイントのキャッシュ上限。
プログラマティック・ツール呼び出し
コード実行サンドボックス内の Python から Claude にあなたのツールを呼ばせる — 往復回数を削り、中間結果をコンテキストの外に保つ。
Admin API：Claude 組織を自動化する
Anthropic Admin API のオペレーターガイド — メンバー一覧、ユーザー招待、RBAC グループ運用、クリーンなオフボーディング。Console と Claude Enterprise、実チームがハマるシートプールと SSO の落とし穴付き。
エージェントのオブザーバビリティ: 再現できないエージェントをトレースする
エージェントの実行は非決定的な分散トレースであり、再実行してもデバッグできません。記録しておくしかないのです。このページでは何を記録すべきかを扱います。OpenTelemetry GenAI のスパン構造（そしてすべての gen_ai.* 属性がいまだ 'Development' である理由）、Claude Code の正確なメトリクス名とイベント名、トレースを Anthropic サポートに結び付ける request-id、エージェントのテレメトリにおける 3 つのプライバシーの落とし穴です。
ファーストパーティの OpenTelemetry トレーシング: 2 つの経路、1 つのトレース
2026 年 10 月から、Claude API と Claude SDK は自前の計装なしで OpenTelemetry のスパンを自ら出力します。ただし 2 つの経路は重複しており、両方を合算するとトークン数が二重になります。このページでは、各経路のセットアップ、トークン数を正直に保つ唯一のルール、トレースを黙って消してしまう traceparent のフラグ、そして 24 時間後に送信先を無効にする配信ルールを扱います。
Usage & Cost Analytics API: 1 ドルずつ帰属させる
Claude の Usage and Cost Analytics API の実践ガイド — 従来の usage_report と cost_report エンドポイントに置き換わったベータ版。行の形、5 次元の制限、actor の意味論、100 倍になるセントの落とし穴、素朴なダッシュボードを壊すデータ鮮度のルール、従来版からの移行表。
Inference Hooks: Claude Enterprise 向けインライン DLP
Claude Enterprise Inference Hooks のオペレーターガイド — チャット、Claude Code、Cowork のあらゆるプロンプトを、モデルが見る前に、あなたの DLP サーバーが許可・拒否できる HTTPS webhook。完全仕様、判定スキーマ、署名、ロールアウトプレイブック。
ユーザープロファイルとエンフォースメント: 1 人の顧客に組織全体を BAN させない
Claude API ユーザープロファイルのオペレーター向けガイド — すべてのリクエストをエンドカスタマーに帰属させ、安全上の制限や BAN が組織全体ではなく 1 つのプロファイルに及ぶようにします。フィールドの完全なリファレンス、4 つの enforcement_status の値、enac_ アクションのスキーマ、組織 Webhook、そしてイベント配信がまだ有効でないために必要なポーリングループ。