クロードオーパス 5.5 のプロンプティング

概要

• Claude Opus 5.5のプロンプト設計パターンと主な改善点を解説
• 旧バージョンからの移行時の注意点と推奨設定
• エージェント運用や進捗報告に関するベストプラクティス
• セーフガード拒否や思考制御の詳細
• 複雑なビジュアル入力やマルチエージェント運用のポイント

Claude Opus 5.5用プロンプト設計ガイド

• Claude Opus 5.5 は、 Claude Opus 5 よりも 30%以上高速 なトークン生成と 少ないトークン消費 が特徴
• 既存の Claude Opus 5用プロンプト はそのままでも高いパフォーマンスを維持
• プロンプト設計パターン は「Prompting Claude Opus 5」が出発点
• 観察状況ごとに推奨セクションを選択
  • エフォートレベル調整が必要な場合：「Calibrate effort」
  • 思考無効化で運用していた場合：「Prompts written for thinking disabled」
  • 長時間タスクで途中停止する場合：「Unattended agentic runs」
  • stop_reason: "refusal"が返る場合：「Safeguard refusals」
  • 進捗報告やユーザー向けアップデートが必要な場合：「User-facing progress updates」
  • マルチアプリ連携で情報不足が発生する場合：「Explore context in multi-app workflows」
  • マルチエージェントの高速化が必要な場合：「Time signals for multiagent harnesses」
  • チャットで初動が遅い場合：「Thinking instructions in chat system prompts」
  • ユーザー貼り付けテキストへの対応：「Mark pasted text in user messages」
  • 複雑なビジュアル入力で情報欠落が起きる場合：「Tools for complex visual inputs」
  • フロントエンド出力の標準化：「Frontend design defaults」

Claude Opus 5.5のプロンプト設計に影響する主な機能

• エージェントコーディングとコードレビュー

  • 実リポジトリでのマルチステップ作業、大規模コードベースの変更やテスト通過までの一貫作業
  • 自律作業の持続力 が向上、複数サブエージェントでの長時間タスクも安定実行
  • コードレビュー精度 向上、バグ検出率増加、誤検出減少、説明も平易

• ナレッジワーク

  • 誤情報や誤引用の減少
  • 財務モデリングやバリュエーションの精度向上
  • 大規模入力からの細部検出、ドキュメント・スライドの編集負担減少

• コミュニケーション

  • 進捗報告や最終要約が明確
  • 必要なユーザーアクションを明示

• チャート・図・スクリーンショット・アプリ操作

  • ビジュアル情報の読解精度向上
  • 位置関係依存の意味把握や変更検出能力の強化
  • スクリーンショットベースのアプリ操作成功率向上

エフォートレベルの調整（Calibrate effort）

• エフォート（effort） は思考量・知性・コスト・遅延の主制御
• デフォルトはmedium （Claude Opus 5はhighがデフォルト）
• Claude Opus 5.5のmediumは、Claude Opus 5のhigh以上の性能
• 低コスト・低遅延重視ならlowを検証
• max_tokensは思考トークンも考慮して十分大きく設定
  • 長いエージェントタスクには最大128,000推奨
• xhighやmaxは品質向上が実証された場合のみ利用
• effort値変更はプロンプトキャッシュ無効化に留意
  • 個別ターンでのeffort変更（β版）はキャッシュ維持

思考無効化プロンプトからの移行（Prompts written for thinking disabled）

• Claude Opus 5.5はthinking: {"type": "disabled"}を非サポート
• 低effortで始めて品質とレイテンシを測定
• 「即答指示」追加で思考短縮も可能だが品質低下に注意
• 思考の代替として理由説明を求めていた指示は削除
  • reasoning_extraction拒否カテゴリに該当する可能性
• レスポンスはブロックタイプで判定
  • thinkingブロックが先頭に来る場合もある

無人エージェント運用時の途中停止対策（Unattended agentic runs）

• 進捗報告のみでターン終了した場合はタスク完了と見なさない
• タスク進行状況をチェックリスト等で管理
• 未完了項目がある場合は自動でユーザーメッセージ送信
• 自動継続は2～3回まで、無限ループ回避
• サブエージェントやバックグラウンド処理中は完了扱いしない
• システムプロンプトで早期停止回避を明示
  • 進捗ノートをツールコールと同じメッセージに含める指示
• リスクのある操作は必ず確認ステップを維持
• ヒューマンインザループ用途ではこの追加指示は省略

セーフガード拒否（Safeguard refusals）

• 生物学・サイバーセキュリティ・推論抽出の安全判定
  • 生物学：Claude Fable 5.1同等、組織向け特別申請可
  • サイバーセキュリティ：脆弱性検出可、ハイリスク用途不可
  • 推論抽出：内部推論の再現を要求するプロンプトは拒否
• 拒否時はstop_reason: "refusal"とstop_detailsで理由提示
• 推論抽出拒否はサーバー側フォールバック不可

ユーザー向け進捗報告（User-facing progress updates）

• ツールコール間で短い進捗アップデートを自動生成
• クライアント側で進捗アップデート受信設定必須
• display: "updates"で各進捗サマリーを取得可能

---

上記以外のトピックや技術的詳細が必要な場合は、個別セクションでご案内可能です。