Agent SDKの記事一覧4ページ目

Claude APIのBrowser Useは、tools配列にbrowser_toolset_20260801を足し、返るtool_useを自前のブラウザで実行します。navigateとread_pageの呼び方、ref参照、エラー処理。

Agent SDKで非同期サブエージェントを動かすと起きていたエラーの原因と、修正済みバージョンをまとめます。

設定を確認したはずのAgent SDKでSkillsが検出されないとき、バージョン・settingSources・cwd・許可リストの4点を順に切り分ける手順です。

TypeScript Agent SDKがLinuxでネイティブバイナリを自動選択する際、glibc環境でもmusl版を先に試して失敗する既知バグの原因と回避策をまとめます。

ant applyはファイルの置き場所からagentやenvironmentなどのkindを推論します。推論の順序、スキップされる条件、最初のagentの適用手順をまとめます。

claude-agent-sdk-pythonのStructuredOutputツールが応答をoutputキーで包み、スキーマ検証が失敗する既知のバグの実態と回避策を解説します。

Python版Claude Agent SDKがrate_limit_eventでMessageParseErrorを起こしreceive_messages()が停止する既知バグの原因と対処をまとめます。

claude-agent-sdk-pythonのissueが報告し続けるcwd無視の症状を、報告の中身と公式ドキュメントの仕様から切り分け、回避策と検証方法を示します。

Agent SDKのcreateSdkMcpServerで複数ツールを同時に呼ぶとStream closedで失敗する既知バグの原因と、環境変数による回避策をGitHub issueの一次情報から解説します。

Docker環境でDEBUG環境変数を設定すると、Python版Agent SDKがCLIからの応答を受け取れなくなる既知の不具合を解説します。原因と回避策、TypeScript SDKとの挙動の違いをまとめます。

CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MSは、進捗のないサブエージェントを強制終了する環境変数です。既定値の連動先、中断後の挙動、他の制御との使い分けをまとめます。

MCPサーバーを増やすほどツール定義がコンテキストを消費します。公式ドキュメントの実測値をもとに、その仕組みとTool Searchが解決する範囲を説明します。

サブエージェントのモデル指定はmodelフィールドか環境変数で行う。優先順位と、Opus/Sonnet/Haikuを役割別に割り当てる原則を公式ドキュメントと料金表から示す。

Claude APIのcompactionが返すcompactionブロックは、次のリクエストへ積み戻さないと会話が続きません。基本の実装手順とストリーミング時の扱いまで示します。

Anthropicが2026年8月に公開した研究から、複数のAIエージェントが同じ場を共有したときに起きる協調の失敗を4つの型で読み解きます。

Claude Managed Agentsとは何か、Agent SDK・Claude Code CLIとどう違うか。分かれ目はインフラの持ち主です。自己ホストでもZDR・HIPAAの対象外になる点も解説します。

Tool Search・Programmatic Tool Calling・プロンプトキャッシュ・Context Editingは圧迫の発生源が違います。導入の判断基準としきい値を扱います。

cache_controlをブロックごとに置かなくても、会話が伸びるたびにキャッシュ境界が自動で前進する仕組みと、20ブロックの遡及窓に引っかかる条件を整理する。

Agent SDKのHooksはoptions.hooksに渡すコールバック関数です。settings.jsonで書くClaude Code CLIのHooksとは実装が別物で、設定方法・入出力・実装例を扱います。

TypeScript Agent SDK 0.3.142でV2セッションAPIが廃止されました。何ができなくなったのか、query()への書き換え方を実装コードで示します。

Agent SDKのテレメトリはCLIが計装する仕組みで、SDKは環境変数経由で設定を橋渡しするだけです。有効化からトレース連結、機微データ制御までを実装コードで説明します。

自前でメッセージ履歴を圧縮すると、task_budgetのカウントダウンはtotalからやり直しになります。remainingに予算の残りを渡し続ける計算と更新のタイミングを、数値例つきで示します。

Claude APIのmid-conversationツール変更は、tools配列を編集せずにツールの提供・撤回を切り替え、プロンプトキャッシュを壊さない仕組みです。対応モデル・ヘッダー・配置制約・メッセージ内定義を扱います。

Claude APIのweb_fetchツールは既定でキャッシュ済みコンテンツを返します。use_cache:falseで最新情報を強制取得する手順とレイテンシとのトレードオフを解説します。

Claude APIが返すエラーのJSON形式と、Python・TypeScript・Go・Ruby・Java・PHP・C#の7言語でSDKが投げる例外クラスの対応表をまとめます。

セッション単位でeffortとマルチエージェントのファンアウトを切り替える「オーケストレーションモード」を、公式ドキュメントの実装パターンから組み立てます。

Sonnet 4.6用のmax_tokensをそのまま流用すると、Sonnet 5では出力が途中で切れます。原因と、effortとmax_tokensの調整方法をまとめます。

入力トークン数を事前計算せずに、コンテキストウィンドウが許す最大量までClaudeに出力させる実装パターンをmodel_context_window_exceededで組む方法を解説します。

Managed AgentsのDreamsは過去セッションを読み込みメモリストアを再構成する非同期ジョブです。仕組み・進捗確認・課金・制限をまとめます。

サーバーサイドcompactionのtrigger.valueをどう決めるか、モデルのコンテキストウィンドウに対する比率と予算管理の計算例で考えます。