Claude Commerce Agents とは？Anthropic の EC エージェント設計図

本記事のポイント

• Claude Commerce Agents は、Anthropic が 2026 年 9 月 2 日に公開した、EC 事業者が自社のサイトやアプリに AI エージェントを組み込むためのオープンソースの参考実装です (Apache 2.0)。カスタマーと会話するショッピングエージェントと、ストア運営を支えるマーチャントエージェントの 2 つが入っていて、小売・旅行・通信・エンタメの 4 業種のデモが付いています
• 中身の核は安全装置です。エージェントが価格や商品を勝手に作れない、ストアのデータへの書き込みは人が承認するまで反映されない、という規則を、プロンプトの指示ではなくコードで縛っています
• OpenAI の ACP や Google と Shopify の UCP は、ChatGPT や Gemini の中で買い物を完結させるための通信規約です。Claude Commerce Agents は、自社サイトの中でカスタマーに買ってもらうためのコードで、役割が違います。日本の EC 事業者が先に用意するものは、商品データの構造化です

Claude Commerce Agents は、Anthropic が 2026 年 9 月 2 日に公開した、EC 事業者が自社のサイトやアプリに AI エージェントを組み込むためのオープンソースの参考実装です。中身は、カスタマーと会話するショッピングエージェントと、ストア運営を支えるマーチャントエージェントの 2 つで、小売・旅行・通信・エンタメの 4 業種のデモが付いています (ライセンスは Apache 2.0)。

OpenAI の ACP や Google と Shopify の UCP が「ChatGPT や Gemini の中で買い物を完結させる」ための通信規約なのに対して、Claude Commerce Agents は「自社サイトの中でカスタマーに買ってもらう」ためのコードです。

この記事では、EC 事業者が導入を判断するために必要な 4 点、①2 つのエージェントの中身 ②安全装置の仕組み ③ACP・UCP との違い ④日本で先に要る準備、を Anthropic の公式ブログ・設計解説・README をもとに整理します。humbulls では実機をまだ動かしていないので、動かした人の報告も引用します。

1. Claude Commerce Agents とは

Claude Commerce Agents は、Claude を使って EC 向けの AI エージェントを構築するための参考実装 (リファレンス実装) です。Anthropic はこれを「設計図 (blueprint)」と呼び、エンジニアリングチームが 数ヶ月ではなく数日でコマースエージェントを動かす ための、ハーネス・パターン・ガードレールの一式だと説明しています。ライブラリでも SaaS でもなく、事業者が fork (自分のリポジトリに複製して改変すること) して自社で育てる前提のコードです。

誤解しやすい点：Claude のアプリで買い物ができる話ではない

Claude Commerce Agents は、Claude のアプリに買い物機能が付いた話ではありません。EC 事業者が自社のサイトやアプリの中に AI の接客と運営支援を組み込むための、開発者向けのコードです。カスタマーが触るのは 各社のサイトであり、Claude の画面ではありません。Anthropic がカスタマーを連れてきてくれるわけでもないので、集客はこれまでどおり事業者の仕事です。

反応：公開 1 日で GitHub スター 1,100 超

公開から 1 日で、GitHub のスターは 1,100 を超えました (2026-09-03 時点)。日本語圏では GIGAZINE が速報を出し、Qiita には Windows でローカル起動を試して失敗した記事が出ています。

まとめると、Claude Commerce Agents は「EC 事業者が自社サイトに置く AI エージェントの、動く見本と安全装置の一式」です。

2. 2 つのエージェントは何をするのか

ショッピングエージェントはカスタマーの買い物を手伝い、マーチャントエージェントはストア運営の判断を手伝います。片方は カスタマーの前に立ち、もう片方はストアのスタッフの後ろに立つ、という分担です。

ショッピングエージェント：カスタマー向け、6 つの機能

ショッピングエージェントは、商品検索、比較、購入計画、カートへの投入、注文や返品ポリシーの質問対応、顧客の文脈の記憶、の 6 つの流れ (Anthropic はスキルと呼びます) を持ちます。事業者は、StorefrontBackend というインターフェースを実装して、このエージェントを自社のカタログ (商品データベース)・カート・注文・ポリシーの各システムにつなぎます。

マーチャントエージェント：ストア運営向け、5 つの機能

マーチャントエージェントは、売上の説明、商品リストの保守、在庫と注文のアラート対応、価格と販促、キャンペーン草案、の 5 つの流れを持ちます。事業者は MerchantBackend を実装して、このエージェントを分析・カタログ・在庫・価格・キャンペーンの各システムにつなぎます。このエージェントがストアのデータに書き込もうとすると、すべて「変更案」として保留され、人が承認するまで反映されません。

4 業種のデモ：架空の企業 ACME

4 業種の参考実装は、この 2 つのエージェントを架空の企業 ACME のストアとして動かしたものです。

機能のスイッチ：カートに触らせない構成もできる

機能は設定で外せます。カート・注文追跡・リスト編集・在庫・価格・キャンペーンのそれぞれにスイッチがあります。たとえば「商品を探して答えるだけで、カートには触らせない」構成にすると、カート関連のツールとプロンプトと接地ルールがまとめて外れます。最初の導入をこの構成から始めれば、エージェントが間違えても被害は「答えが違う」までで済みます。

Claude Code プラグイン：4 コマンドで土台を作る

Claude Code のプラグイン commerce-builder も同梱されています。このプラグインは、自社の技術スタックを聞き取ってエージェントの土台を作る、流れを追加する、評価ケースを書く、既存エージェントを点検する、の 4 コマンドを持ちます。

発表文によると、Wix のエンジニアは 15 分で動くコマースエージェントを作り、Fetch は 1 時間以内に両方のエージェントをローカルで動かしました。ただし、どちらも各社のエンジニアが動かした時間です。「動くまで 15 分」であって、「自社で使えるまで 15 分」ではありません。

2 つのエージェントは接客と運営の仕事を分担し、決済・価格・在庫の変更のようなお金に関わる操作は、人の承認かホスト側の手続きに渡す作りです。

3. Claude Commerce Agents の中身は安全装置 — プロンプトではなくコードで縛る

Claude Commerce Agents の中身で最も重要なのは、モデルの賢さではなく安全装置です。「価格を作らない」「勝手に注文しない」といった規則を、プロンプトの指示ではなくコードで強制しています。Anthropic の設計解説に、その考え方を表す一文があります。

The prompt is where safe behavior starts, but in commerce it can't be where safety is enforced. (プロンプトは安全な振る舞いの出発点だが、コマースでは安全を強制する場所にはなり得ない) — Anthropic「The anatomy of effective commerce agents」(2026-09)

なぜコードで縛るのか：EC の失敗は金銭の事故になる

EC でモデルが間違えると、すぐにお金の問題になります。モデルが価格を言い間違える、存在しない商品を勧める、注文を二重に入れる、のどれも返金と謝罪に直結します。

だから Anthropic は、「そうしないように」とプロンプトで指示するだけでは足りず、そもそもできない構造をコード側に置く という考え方を取っています。人間の店員に「間違えないでね」と言うだけでなく、レジの操作権限そのものを分ける、という発想です。

4 つの層：ハーネス・スキル・ツール・UI

エージェントは 4 つの層で組まれています。

ハーネス

セッション状態・承認ゲート・ID の追跡・安全規則の強制を担う中核。モデルの外側にあります

スキル

検索・価格・在庫・キャンペーンといった業務知識のまとまり。ツールの結果として読み込まれます

ツール

既存の業務システム (検索エンジン・カート・在庫) を呼ぶ API。システムを作り直すのではなく、あるものを呼びます

UI コンポーネント

商品カルーセル・旅程・比較表などを、型の決まったデータとして画面に出す仕組み

5 つの安全装置：ハーネスとツールの間に入る

安全装置は、このハーネスとツールの間に入っています。主なものは 5 つです。

構成：1 つのモデルで回す

参考実装は、複数のサブエージェントを使わず、1 つのモデルがループを回す構成です。Anthropic は、コマースの会話が密に結びついた 1 つのセッションであることを理由に挙げています。同社の比較では、単一エージェントにスキルを持たせる構成が 品質・コスト・レイテンシのすべてで勝った と報告されています。

コスト：キャッシュ命中率 90〜99%

コストの見当も設計解説に書かれています。会話の大半はプロンプトの再利用なので、プロンプトキャッシュ (同じ前置きを再利用して安く読み込む仕組み) の命中率は優れた運用で 90〜99% に達し、キャッシュ読み込みの単価は新規トークンの約 10 分の 1 になります。ツールの引数が届き次第呼び出しを始める工夫で、数秒の待ちが数百ミリ秒に縮んだ、という報告もあります。

安全装置がコード側にあるので、モデルが間違えても、価格の捏造や勝手な注文はエージェントの外に出ません。

4. OpenAI の ACP・Google の UCP と何が違うのか

違いは、カスタマーがどこで買うかです。ACP と UCP は、ChatGPT や Gemini の中で買い物を完結させるための通信規約です。Claude Commerce Agents は、事業者のサイトの中でカスタマーに買ってもらうためのエージェントのコードです。

ACP・UCP：カスタマーは AI アプリの中で買う

ACP (OpenAI と Stripe が 2025 年 9 月に公開した Agentic Commerce Protocol) と UCP (Google と Shopify が 2026 年 1 月に公開した Universal Commerce Protocol) は、AI アプリとマーチャントのシステムをつなぐ通信規約です。

マーチャントは、自分のカタログと決済を規約に合わせて公開します。ChatGPT や Gemini はそこに接続し、商品の提案から決済までを自分の画面の中で完結させます。カスタマーは AI アプリから出ず、決済は Stripe や参加する決済網が処理します。

Claude Commerce Agents：カスタマーは自社サイトの中で買う

Claude Commerce Agents は、事業者が自社サイトに置く接客エージェントのコードです。事業者はこのコードを fork して、自社のカタログ・カート・注文システムに接続します。

カスタマーは事業者のサイトにいたまま、エージェントと会話して商品を選びます。決済はエージェントが処理せず、自社のチェックアウト画面 (購入手続きページ) にカスタマーを移して、そこで処理します。Anthropic が配ったのは通信規約ではなく、エージェントの作り方です。

両方を組み合わせる：Shopify の実装例

ACP・UCP と Claude Commerce Agents は、担当する場所が違うので、両方を同時に使えます。Shopify が同じ日に公開した実装例がその形です。

Claude のショッピングエージェントがカスタマーの相談に乗り、商品をカートに入れるところまでを担当します。カスタマーが買いたい商品をカートに入れ終えると、エージェントは自分で決済に進む代わりに、Shopify 標準のチェックアウト画面にカスタマーを移します。支払いはそこで Shopify が処理するので、エージェントはお金に触りません。エージェントとストアのシステムの間の通信には、Shopify の UCP エンドポイントを使っています。

補足：OpenAI は 2026 年 3 月に方針を変えた

OpenAI は 2026 年 3 月、ChatGPT の中で購入を完結させる Instant Checkout を「アプリの中へ移す」と発表し、注力先を商品の発見に変えました。在庫の同期や税計算まで AI 会社側で抱えるのは重い、という判断です。事業者のサイト側にエージェントを置く Anthropic の設計は、この流れと同じ方向を向いています。

カスタマーを AI アプリの中で迎えるなら ACP・UCP への対応、自社サイトの中で迎えるなら Claude Commerce Agents、という切り分けになります。

5. 発表から 1 日で分かっていること、分かっていないこと

分かっていることは README に明記された 5 点で、分かっていないことは効果の数字・日本語での精度・実運用のコストの 3 点です。

分かっていること

• コードは全文公開で、ライセンスは Apache 2.0。参考実装は保守されず、fork して自社で維持する前提 (README)
• 参考実装は何も注文せず、カードに課金せず、公開中の商品リストも変えない。チェックアウトはカートの表示までで、完了はホスト側 (README)
• サンプルには認証がなく、MCP サーバーはループバックにしか束縛されない。そのまま公開環境に置くものではない (README)
• MCP コネクタは同梱されない。自社システムへの接続はバックエンドのインターフェースを自分で実装する (README)
• 対応 OS は明言されていないが、Windows での起動には失敗報告があり、WSL2 か Linux が勧められている (Qiita)

分かっていないこと

• 「カートが最大 35% 大きく、購入完了が 60% 高い」という数字の条件。どの小売業者で、何と比べたかは開示されていません。「最大 (up to)」付きの数字で、平均ではありません
• 日本語カタログでの検索精度と、日本語の接客文の品質。プロンプトとスキルは英語で書かれています
• 実運用のコスト。API の従量課金で、キャッシュの命中率と 1 タスクあたりのターン数で大きく変わります。Anthropic 自身も「モデル呼び出し単位ではなく、完了したタスク単位で測る」ように書いています

数字の扱い：35% と 60% は目標値にしない

数字を自社に当てはめるときは、35% と 60% を目標値にしないほうが安全 です。Anthropic はこの数字を「最大 (up to)」付きで公表していて、条件も母数も出していません。同社が挙げる Vambe の事例 (小規模事業者の販売エージェントで転換率 40% 向上) も同じで、条件が違えば再現しません。稟議に書くなら「Anthropic が公開している参考値」と添えるのが適切です。

分かっているのはコードの範囲と制約で、分かっていないのは自社に当てはめたときの効果です。

6. 日本の EC 事業者に要る準備 — 商品データの構造化が先

日本の EC 事業者が 先に用意するものは、コードではなく商品データ です。エージェントは商品データの「属性」しか検索に使わないので、属性が整っていないと、条件に合う商品があっても見つけられません。

検索の仕組み：属性・タイトル・オプション値しか見ない

ショッピングエージェントの商品検索は、クエリと絞り込み条件で最大 8 件を返す仕組みです。絞り込みが見るのは属性・タイトル・オプション値だけで、仕様表や説明文の中にしかない事実は検索に効きません。コードを読み込んだ Commerce Clarity の Daniele Vella 氏は、条件に合う商品があっても「似た商品のリスト」が返ると書いています。同氏の検証では、63 個の事実を仕様表から属性へ移す作業が必要 でした。

準備の中身：3 つ

条件は項目にする

「防水」「耐荷重 300 kg」「法人向け」のようにカスタマーが条件にする事実は、説明文ではなく商品属性として持つ

値は比べられる形にする

重量が「254 g」「2.1 kg」「35 lb」と混在していると比較できません。単位を揃え、数値として持つ

適用範囲を持たせる

同じ事実でも、バリエーション・販売地域・チャネルで有効かどうかが変わる。どこで使える値かを持つ

Shopify Japan が加盟店に勧めている準備 も同じです。同社のブログは、AI が読める形式の商品データ、「誰のための商品か」という文脈情報、レビューやコンテンツによる信頼の 3 つを挙げています。順番は、商品データ、文脈、信頼です。

開発体制：エンジニアがいなければマネージド型

開発体制の面で要るのは 3 つです。Python 3.11 以上と Node 22 が動く環境、Claude API の鍵、そしてバックエンドの接続を書けるエンジニアです。

その体制がなく、Shopify を使っている事業者には別の道があります。Shopify Inbox のマネージド版ストアフロントエージェント (コード不要) という選択肢 を、Shopify 自身が README で案内しています。Claude Commerce Agents は読んで学ぶ材料にして、実装はマネージド型に任せる、という組み合わせも成り立ちます。

準備の順番は、商品データの属性化、開発体制の確認、コードの fork です。

7. 使う場合と見送る場合

Claude Commerce Agents を使う価値があるのは、カスタマーとの会話を自社の画面の中で持ちたい事業者 です。ChatGPT や Gemini の中で買ってもらう方針なら、ACP・UCP への対応が先になります。

使う価値があるケース

• 自社のサイトやアプリを持ち、接客の会話を自社の画面の中で完結させたい
• 商品が旅行・通信・チケットのように、日付・契約・仮押さえの制約を持ち、汎用のチャットボットでは扱えない
• カタログの属性がすでに構造化されているか、整備する体制がある
• エージェントの安全設計を一から考えるコストを、実績のある構造を読むことで省きたい

見送ったほうがいいケース

• 販売の主戦場が楽天や Amazon などのモール。その場合はモール側の AI や、UCP のような規約の動向を見るほうが先
• 商品情報が PDF や自由文で、属性化に半年以上かかる
• 開発者がいない。Shopify Inbox のようなマネージド型か、EC プラットフォーム側の機能を待つ
• 価格が相対で決まる BtoB の見積販売。ただしマーチャントエージェントの「変更案を人が承認する」構造は、見積の下書きや在庫の警告には転用できます

BtoB 企業にとっての価値：承認してから反映する構造

humbulls の読者の多くは BtoB で、EC を持たない会社も多いはずです。それでも、マーチャントエージェントの「変更案を人が承認してから反映する」構造は、見積の下書きや CRM の更新のような業務にそのまま移せます。AI に書かせて、人が承認して、初めて反映される、という順番を守るだけで、事故の大半は防げます。

判断の軸は「カスタマーとの会話を自社の画面で持つか」の 1 つで、持つなら Claude Commerce Agents を読む価値があります。

8. Claude Commerce Agents についてよくある質問

Q. 無料で使えますか？

コードは Apache 2.0 で無償です。動かすには Claude API (または Bedrock・Vertex AI・Foundry) の従量課金がかかります。サンプルを起動するにも API キーが要ります。

Q. Claude のアプリで買い物ができるようになるのですか？

できません。Claude Commerce Agents は EC 事業者が自社のサイトやアプリに組み込むためのコードで、カスタマーが触るのは各社の画面です。ChatGPT のように AI アプリの中で買う仕組みは、ACP や UCP が担っています。

Q. Shopify で使えますか？

使えます。Shopify が公式に実装例を公開しています。ショッピングエージェントを Shopify の UCP エンドポイントにつなぎ、決済は Shopify のチェックアウト画面に渡す構成です。コードを書かない選択肢として、Shopify Inbox も案内されています。

Q. 決済は誰が処理しますか？

エージェントは処理しません。参考実装は 「何も注文せず、カードに課金しない」 と明記されていて、エージェントの役割はカートを表示するところまでです。その先の支払いは、ホスト (自社のチェックアウトや EC プラットフォーム) が担います。

Q. 日本語で動きますか？

Claude 自体は日本語を扱えますが、同梱のプロンプト・スキル・サンプルデータは英語で、架空の企業 ACME のものです。日本語カタログでの精度は、自社データで評価ケースを作って確かめる必要があります。設計解説は、流れごとに 50〜100 件の評価ケースを勧めています。

まとめ

Claude Commerce Agents は、ChatGPT や Gemini の中で買う流れとは別に、自社の EC サイトに AI の接客を置くための参考実装です。中身の核はモデルの賢さではなく、価格や商品を作らせず、書き込みを人が承認するまで通さない、コード側の安全装置にあります。

日本の EC 事業者にとって、いまやる準備は fork ではなく商品データの属性化 です。それが済んでいれば、ACP・UCP と Claude Commerce Agents のどちらを先にやるかは、「カスタマーとの会話を自社の画面で持つか」で決まります。

私たち humbulls は、EC の運用支援を主戦場にしていません。それでもこの参考実装の「変更案を人が承認する」構造は、BtoB マーケティングの運用を AI に任せるときの型としてそのまま使えると考えています。まず自社のデータを AI が読める形にして、次に、AI の書き込みを人が承認する構造にします。順番はこの 2 つです。

関連する整理は次の記事にあります。

• AI に何を渡すかの判断: Claude とは — マーケ業務 24 個を検索と AI に仕分ける判断軸
• AI 検索から自社が見つかる側の対策: AEO・GEO・LLMO とは
• BtoB マーケ全体の AI 活用: 生成 AI × BtoB マーケティング大全

自社サイトへの AI 実装や運用設計の相談は、Growth Partner サービス で承っています。

参考文献

• Building commerce agents with Claude — Anthropic 公式ブログ (取得日: 2026-09)
• The anatomy of effective commerce agents — Anthropic 設計解説 (取得日: 2026-09)
• anthropics/commerce-agents — GitHub リポジトリ README (取得日: 2026-09)
• Shopify/claude-for-commerce-examples — Shopify 実装例 (取得日: 2026-09)
• Stripe powers Instant Checkout in ChatGPT and releases Agentic Commerce Protocol codeveloped with OpenAI — Stripe (取得日: 2026-09)
• Building the Universal Commerce Protocol — Shopify Engineering (取得日: 2026-09)
• OpenAI shifts checkout plans in its agentic commerce strategy — Digital Commerce 360 (取得日: 2026-09)
• We read the Claude Commerce Agents code. Here is what it asks of your catalog. — Commerce Clarity (取得日: 2026-09)