Claude Fable 5の進捗報告をツール結果に照合させる指示文
Claude Fable 5の長時間実行で、完了していない作業を完了と報告させない指示文の全文、効く理由、システムプロンプトやCLAUDE.mdへの置き方を解説します。
サブカテゴリ
Agent SDKのTips一覧
Agent SDKを日々使うなかで効く小技・設定・ワークフローをまとめたTipsの一覧です。1記事1テーマで、すぐ試せる粒度に絞っています。
全70件 · 最終更新 2026/10/17
記事一覧
Managed Agentsを本番に出す前のセキュリティ点検 — 8項目の確認表
Managed Agentsの本番前に確認する設定を、ネットワーク・vault・Web系ツール・承認・ツール数・信頼できない入力・予算と停止手順の8項目に整理。危険な既定値も示します。
claude-code-actionでCredit balance is too lowが出る原因と回避策
残高がありclaude -pは通るのに、claude-code-actionだけ「Credit balance is too low」で落ちる報告です。環境変数での切り分けと、報告者が試した回避策を載せます。
Agent SDKのstartup()とWarmQueryで初回queryの起動待ちを消す
TypeScript Agent SDKのstartup()は、サブプロセスの起動と初期化を先に終わらせます。WarmQueryの使い方、initializeTimeoutMs、prewarm()との使い分けを解説します。
Agent SDKのpermission_deniedイベントで拒否をUIに出す方法
permission_deniedが出る条件は、canUseToolやMCPプロンプトツールの有無で変わります。PreToolUse経由の拒否が出ない点と、permissionPrompts: 'none'の使いどころを示します。
Claude APIのweb_search料金 — 1,000回10ドルと入力トークンの積み上がり
Claude APIのweb_searchは1,000検索10ドルの従量課金です。検索1回の数え方、エラー時の扱い、結果が入力トークンに積まれる仕組み、max_usesで費用を抑える考え方を解説します。
Claude APIのweb fetch料金は追加なし — max_content_tokensで絞る
web_fetchツールの料金は取り込んだ内容の標準トークン分だけです。10kBで約2,500トークン、PDF 500kBで約125,000トークンという目安と、max_content_tokensが効く範囲を説明します。
Claude Haiku 5.5のプロンプトガイド — 症状別に足す文面と設定
Haiku 5.5で起きがちな早期停止・検証漏れ・JSON出力でのツール呼び出し漏れ・チャットボットの逸脱を、システムプロンプトに足す文面とeffortの設定で直す手順を症状別に並べます。
CLAUDE_CODE_TRANSCRIPT_LOCAL_GCで-pの履歴肥大を抑える
-pやAgent SDKの長いセッションで膨らむtranscriptを、コンパクション後に5MB超なら前の履歴を削って抑える環境変数です。起動環境でしか指定できない点と、resumeで会話が変わらない点を扱います。
Agent SDKのMCP接頭辞を外す — CLAUDE_AGENT_SDK_MCP_NO_PREFIXの使い方
CLAUDE_AGENT_SDK_MCP_NO_PREFIXを1にすると、SDKで作ったMCPサーバーのツール名からmcp__サーバー名__が消えます。設定の渡し方と、権限ルール・フックへの影響を確認します。
Claude Sonnet 5.5のプロンプトガイド — 前置き思考なしと検証の書き方
Claude Sonnet 5.5で起きがちな症状ごとに、システムプロンプトへ足す文面と消す文面を整理。前置き思考なし運用、ターン途中のユーザーメッセージ、検証の指示まで実例で扱います。
Claude Opus 5.5のエージェントが途中で止まるのを防ぐ設定
Claude Opus 5.5は長時間タスク中もテキストのみのend_turnで応答を終えることがあります。無人実行のハーネスがそれを完了と誤判定しないための実装パターンをまとめます。
Claude Opus 5.5のマルチエージェントに経過時間を伝えて完了を早める
Claude Opus 5.5は経過時間の情報に敏感です。マルチエージェントのハーネスに
elapsed 340s / 1200sのような行を足すと、品質を保ったまま完了を早められます。CLAUDE_CODE_STARTUP_FAILURE_RESULTSで起動失敗の理由を取得する
起動拒否の理由をstderrでなくresultメッセージで受け取る環境変数の仕様と、Agent SDKでの受け方をまとめます。
CLAUDE_CODE_SYNC_SKILLSの2つのタイムアウト変数を使い分ける
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MSとCLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MSは効く局面が違います。既定値と超過時の挙動を分けて見ます。
Claude Agent SDKでOpus 5.5がAPI Error 400になる原因と対処法
claude-agent-sdk(Python)でmodel="claude-opus-5-5"を指定すると400エラーになる原因は、SDKが同梱するCLIバージョンの古さです。修正済みの版、成功扱いで返る見分け方、回避策を示します。
Claude Sonnet 5は指示を文字通り解釈し、範囲を広げない
Claude Sonnet 5は指示を一般化せず文字通り実行します。effortとの関係、範囲を明示する書き方とコードレビューでの影響をまとめます。
Claudeに破壊的操作を確認させるプロンプト設計
公式プロンプトエンジニアリングガイドの「reversibility」原則に基づき、破壊的操作の前にClaudeへ確認を求めさせるプロンプトの書き方と、権限システムとの役割の違いを示します。
claude-agent-sdkのwheelが公開されず、pip installに失敗する原因と対処法
claude-agent-sdkのPyPI公開が一部失敗しwheelが欠けると、uvやpipのインストールが止まります。2026年3月の障害と9月の再発を、PyPIの実際のファイル一覧と切り分け手順で追います。
Claude Agent SDKで(no content)テキストが出る原因と対処法
Claude Agent SDKでthinkingブロックの前に(no content)という空テキストが混入する不具合の原因・修正バージョン・防御的な実装をまとめます。
大きいメッセージでJSONDecodeErrorが発生し停止する原因と対処
Python版Claude Agent SDKで大きな応答時にCLIJSONDecodeErrorが起きる原因と、現行SDKでのmax_buffer_size対処をまとめます。
MCP_TOOL_TIMEOUTを設定しても5分で切れるAgent SDKのMCPツール呼び出し
Agent SDK TypeScriptでMCP_TOOL_TIMEOUTを伸ばしてもMCPツール呼び出しが5分で失敗する既知報告と、原因が一致する公式修正、確認しておきたい設定をまとめます。
Fable 5.1のxhigh/maxでmax_tokensに達し出力が切れる問題と対処
Claude Fable 5.1をxhigh・maxのeffortで使うと、モデルが思考内で下書きしてから本文を書き直すためmax_tokensに達し出力が切れることがあります。原因と対処法をまとめます。
Claude Fable 5.1のサブエージェント並行作業でリードを待たせない設計
起動ツールの即時リターン・結果の後続メッセージ投入・待機専用ツールの3点で、Claude Fable 5.1のリードエージェントはサブエージェント実行中も動かし続けられます。
Claude Fable 5.1の保持指示でcompactionの要約を書く方法
Claude Fable 5.1でクライアント側のcompactionを自前実装し、要約から制約や決定事項が消えるときの対処です。公式の保持指示の日本語訳例と、圧縮方式ごとの渡し方、thinkingブロックの扱いを示します。
「SDK execution error」でclaude-code-actionが落ちる原因と対処法
「SDK execution error」のログに出る圧縮コードは本当の原因ではありません。認証・残高・モデルID・引数の4系統の見分け方を、issueの報告からまとめます。
only prompt commands are supported in streaming modeエラーの原因
Agent SDKで非同期サブエージェントを動かすと起きていたエラーの原因と、修正済みバージョンをまとめます。
rate_limit_eventでMessageParseErrorが発生し停止する原因と対処
Python版Claude Agent SDKがrate_limit_eventでMessageParseErrorを起こしreceive_messages()が停止する既知バグの原因と対処をまとめます。
MCP Stream closedエラーはAgent SDKの並列呼び出しで起きる
Agent SDKのcreateSdkMcpServerで複数ツールを同時に呼ぶとStream closedで失敗する既知バグの原因と、環境変数による回避策をGitHub issueの一次情報から解説します。
Agent SDKがDockerのDEBUG環境変数で動かなくなる原因と回避策
Docker環境でDEBUG環境変数を設定すると、Python版Agent SDKがCLIからの応答を受け取れなくなる既知の不具合を解説します。原因と回避策、TypeScript SDKとの挙動の違いをまとめます。
記事は新しい順に並んでいます。基本操作の時短から一歩進んだ自動化まで幅があるので、いま困っていることに近いタイトルから開けます。前提となるAgent SDKのセットアップはチュートリアル、挙動の背景を知りたいときは解説の記事が補完になります。同じカテゴリ内のタイプ別セクションから辿れます。