CLAUDE LABEN
AGENTS — Managed Agentsのセッション作成時にagent_with_overridesを渡すと、そのセッションだけモデル・システムプロンプト・ツール・MCPサーバー・スキルを差し替えられますKEYS — Claude ConsoleでAPIキーに有効期限を設定できるようになりました。プリセット・カスタム期間・無期限から選べ、7日以上のキーは失効前にメール通知が届きますMCP — 管理者がIDプロバイダ経由で組織全体にMCPコネクタをプロビジョニングできるようになりました。Okta起点で、ユーザーは初回ログイン時に自動でコネクタを使えますWORKBENCH — 旧Workbench(platform.claude.com/workbench)は8月17日で提供終了です。プロンプト生成・改善・テンプレート化の実験的APIも同日に廃止されますREVIEW — Claude Codeにバックグラウンドの/code-reviewが追加され、レビュー中も作業を続けられます。あわせてMCPやWindowsのパス処理が改善されましたFASTEND — Claude Opus 4.7のfastモードは本日7月24日で削除されます。speed: 'fast'を指定している箇所はOpus 4.8への移行が必要ですAGENTS — Managed Agentsのセッション作成時にagent_with_overridesを渡すと、そのセッションだけモデル・システムプロンプト・ツール・MCPサーバー・スキルを差し替えられますKEYS — Claude ConsoleでAPIキーに有効期限を設定できるようになりました。プリセット・カスタム期間・無期限から選べ、7日以上のキーは失効前にメール通知が届きますMCP — 管理者がIDプロバイダ経由で組織全体にMCPコネクタをプロビジョニングできるようになりました。Okta起点で、ユーザーは初回ログイン時に自動でコネクタを使えますWORKBENCH — 旧Workbench(platform.claude.com/workbench)は8月17日で提供終了です。プロンプト生成・改善・テンプレート化の実験的APIも同日に廃止されますREVIEW — Claude Codeにバックグラウンドの/code-reviewが追加され、レビュー中も作業を続けられます。あわせてMCPやWindowsのパス処理が改善されましたFASTEND — Claude Opus 4.7のfastモードは本日7月24日で削除されます。speed: 'fast'を指定している箇所はOpus 4.8への移行が必要です
記事一覧/API & SDK
API & SDK/2026-07-24上級

メモリストアの棚卸しが半分しか返らない — path_prefix セグメント一致への移行

Managed Agents のメモリ一覧が agent-memory-2026-07-22 で仕様変更されました。順序固定・depth 厳格化・path_prefix のセグメント一致。棚卸しスクリプトが静かに件数を落とした実例と、破壊的変更に耐えるアクセス層の設計をまとめます。

Claude46Managed Agents3Memory3API27移行3

プレミアム記事

朝の棚卸しスクリプトが、いつもより静かでした。

私は個人開発で、数本のアプリの運用をひとつの Managed Agents セッションに任せております。夜間にクロール状況・課金・問い合わせを見て、朝に要約を置いておく。そのために、プロジェクトごとのメモリストアへ「前回の判断」「触ってはいけない設定」を書き溜めております。

毎朝、そのメモリを一覧して差分を眺めるのが習慣でした。ところがある朝、一覧が拾ってくる件数が減っていました。前日は全プロジェクト合わせて 68 件だったものが、その朝は 39 件。ほぼ半分です。エラーは出ていません。例外も、警告も、何も。ただ静かに、いくつかのプロジェクトのメモリだけが結果から消えていました。

原因は、前夜に上げたベータヘッダーひとつでした。agent-memory-2026-07-22

メモリストアの一覧を、なぜ自前で叩くのか

Managed Agents のメモリストアは、セッションのコンテナに /mnt/memory/ としてマウントされ、エージェントは通常のファイルツールで読み書きします。ここまでは、エージェントに任せておけば済む話です。

一覧 API を人間側から叩くのは、別の目的のためです。エージェントが書いたものをレビューする。誤った記憶を訂正する。定期的にエクスポートして棚卸しする。私の場合は毎朝の差分確認で、memories.listpath_prefix で絞り込みながらプロジェクト単位に巡回しておりました。

メモリは 1 件あたり 100 kB(およそ 25,000 トークン)が上限で、公式にも「大きな数本ではなく、小さく焦点を絞った多数のファイルに分けよ」と書かれています。私はこれに従い、/projects/alpha/decisions/2026-07.md のように、プロジェクト名を第1セグメントに置く木構造で運用しておりました。この設計が、今回の変更でちょうど急所を突かれた形になります。

agent-memory-2026-07-22 で変わった3点

ベータヘッダーを agent-memory-2026-07-22 に上げると、memories.list の挙動が3点変わります。順に見ていきます。

項目変更前変更後(agent-memory-2026-07-22)
一覧の順序order_by / order で制御サーバ定義の安定順に固定。order_by / order無視
depth の値任意の整数を受け付けていた01・省略のみ。それ以外は 400
path_prefix の一致部分文字列(substring)一致末尾スラッシュ必須。パスセグメント単位の一致

順序固定と depth 制限は、読めば身構えられます。困るのは3つ目です。挙動が「エラーではなく、静かに違う結果」に振れるからです。

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
agent-memory-2026-07-22 で変わった3点: 一覧順序の固定・depth の値制限・path_prefix のセグメント一致
末尾スラッシュ無しの path_prefix が黙って0件を返す落とし穴と、その再現手順
順序とプレフィックス挙動に依存しない、破壊的変更に耐えるメモリ棚卸し層の実装
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

API & SDK2026-06-21
公開したくない社内サービスに Managed Agents を繋ぐ — MCP トンネル設計の勘所
Claude Managed Agents から、インターネットに公開していない社内 MCP サーバーへ安全に接続する設計を扱います。MCP トンネル・自前サンドボックス・認可境界・障害時の縮退まで、実運用で必要な判断を整理しました。
API & SDK2026-07-14
ユーザーに届くAI生成の短文を、公開前に二段ゲートで止める
アプリでユーザーに配信するAI生成の短文に、決定的ルール層とClaude分類層の二段公開ゲートを組む設計です。fail-closed・生成時検疫・コスト設計まで、実装コード付きで整理しました。
API & SDK2026-07-12
非ストリーミングの長い応答が10分の壁で黙って二重課金されていた — SDK既定のタイムアウトと自動リトライを設計し直す
Anthropic SDK の既定タイムアウト10分と自動リトライ2回が、長い非ストリーミング応答を裏で二重に走らせて課金することがあります。発生の仕組みと、ストリーミング切替・明示的な timeout/max_retries・ローカル台帳で止める実装を、実測値とともにまとめました。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →