Anthropic 공식 계정 @ClaudeDevs는 X(옛 트위터)를 통해 "We're open-sourcing Claude Commerce Agents. This is a blueprint for building shopping and merchant agents, with reference implementations across retail, travel, telecom, and entertainment."(클로드 커머스 에이전트를 오픈소스로 공개합니다. 이는 쇼핑 및 머천트 에이전트를 구축하기 위한 청사진이며, 리테일·여행·통신·엔터테인먼트 전반에 걸친 참조 구현을 포함합니다.)라고 발표했습니다.
발표 내용
이번에 공개된 '클로드 커머스 에이전트(Claude Commerce Agents)'는 쇼핑 에이전트(shopping agent)와 머천트 에이전트(merchant agent) — 각각 소비자를 대신해 구매를 돕는 에이전트와 판매자 업무를 돕는 에이전트를 뜻합니다 — 를 구축하기 위한 청사진(blueprint), 즉 개발자가 참고할 수 있는 설계 틀입니다. Anthropic은 이를 오픈소스로 공개하면서 리테일, 여행, 통신, 엔터테인먼트 등 여러 산업 분야에 걸친 참조 구현(reference implementation) — 실제로 동작하는 예시 코드 — 도 함께 제공한다고 밝혔습니다.
사용자에게 갖는 의미
개발자와 기업은 이 청사진을 바탕으로 자사 서비스에 맞는 쇼핑·판매 관련 에이전트를 직접 구축할 수 있습니다. 리테일, 여행, 통신, 엔터테인먼트 등 서로 다른 업종에 대한 참조 구현이 함께 제공되므로, 각 산업의 특성에 맞춘 에이전트 개발의 출발점으로 활용할 수 있을 것으로 보입니다.
어떻게 사용할 수 있나요 — 세 가지 시작점
공식 README(anthropics/commerce-agents) 기준으로 이 청사진은 세 가지 방식으로 시작할 수 있습니다. 코드를 쓰지 않고 데모만 띄워 볼 수도 있고, Claude Code 플러그인으로 자사 시스템에 맞는 에이전트를 자동 생성할 수도 있습니다.
- ① 데모 실행 — 리테일·여행·통신·엔터테인먼트 4개 업종 예제를 로컬에서 그대로 띄워 봅니다. 요구사항은 Python 3.11 이상, Node 22, Anthropic API 키입니다.
- ② Claude Code 플러그인으로 직접 만들기 — 동봉된
commerce-builder플러그인이 내 기술 스택을 묻고 계획을 보여 준 뒤 프로젝트를 생성합니다. - ③ 실행 환경 선택 — 같은 프롬프트·스킬·툴 정의를 Messages API, Claude Agent SDK, Claude Managed Agents(베타) 중 어디서든 실행할 수 있습니다.
① 데모 실행 — 4개 업종을 로컬에서 바로 띄우기
git clone https://github.com/anthropics/commerce-agents.git && cd commerce-agents
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt # 패키지 7개와 고정 의존성
cp .env.example .env # ANTHROPIC_API_KEY 입력
(cd examples && npm ci) # 웹 앱 8개가 공유하는 워크스페이스
python scripts/run_demo.py retail # API :8000 + 스토어프론트 :3000retail 자리에 travel, telecom, entertainment를 넣으면 다른 업종 데모가 뜹니다. --merchant 옵션은 쇼핑 화면 대신 머천트(판매자) 포털을, --all은 둘 다 실행합니다. 포트는 스토어프론트가 3000~3003, 포털이 3100~3103입니다. 각 예제 README에 "Try" 섹션이 있어 어떤 질문을 던져 보면 좋은지 안내합니다.
② Claude Code 플러그인으로 내 서비스용 에이전트 만들기
레포를 클론한 상태에서(플러그인이 이 레포를 참조 구현으로 읽습니다) 아래 순서로 진행합니다.
claude plugin marketplace add anthropics/commerce-agents
claude plugin install commerce-builder@claude-commerce-agents
claude
/scaffold-commerce-agent a shopping assistant for our store플러그인이 제공하는 명령은 네 가지입니다.
- /scaffold-commerce-agent — 기술 스택을 질문하고 계획을 확인받은 뒤 프로젝트를 생성합니다.
- /add-commerce-flow — 생성된 에이전트에 새 업무 흐름(flow)을 추가합니다.
- /author-commerce-evals — 에이전트 품질을 검증할 평가(eval)를 작성합니다.
- /review-commerce-agent — 이미 만들어 둔 에이전트를 청사진 기준으로 점검합니다.
README에 따르면 요청 내용이 각 명령의 설명과 맞으면 명령 이름을 직접 입력하지 않아도 자동으로 실행됩니다. 플러그인 설치 방법이 낯설다면 클로드 플러그인 총정리를 먼저 보시면 됩니다.
③ 실행 환경 — Messages API·Agent SDK·Managed Agents
세 경로 모두 동일한 프롬프트·스킬·툴 계약을 공유합니다.
- Messages API — 기준이 되는 루프입니다.
ShoppingAgent에 자사 백엔드와 스킬 디렉터리를 넘기고stream_turn으로 대화 턴을 스트리밍합니다. - Agent SDK — 같은 정의를 SDK가 루프를 돌리며 실행합니다. 예:
python shopping-agent/runtime-agent-sdk/main.py --once "a two-person tent under $250". SDK 자체가 처음이라면 Claude Agent SDK 가이드를 참고하세요. - Managed Agents(베타) — Anthropic이 호스팅하는 에이전트가 자사 MCP 서버를 호출합니다.
scripts/deploy_managed_agent.sh로 배포합니다.
배포 대상은 Claude API 외에 Amazon Bedrock, Microsoft Foundry, Google Cloud Vertex AI도 지원한다고 발표문과 레포의 docs/deployment.md에 명시돼 있습니다.
두 에이전트가 실제로 하는 일
- 쇼핑 에이전트 — 카탈로그 검색, 상품 비교, 여러 품목을 한 번에 담는 계획, 장바구니 구성과 체크아웃 인계, 주문 조회·반품·환불 정책 답변, 고객 선호 기억. 자사 카탈로그·장바구니·주문·정책 시스템 위에
StorefrontBackend인터페이스를 구현해 연결합니다. 에이전트의 다섯 가지 업무 흐름은shopping-agent/skills/의 스킬(SKILL.md)로 정의돼 있습니다. - 머천트 에이전트 — 판매 성과 설명, 리스팅 유지 관리, 재고·주문 알림 대응, 가격·프로모션 제안, 마케팅 캠페인 초안 작성. 분석·카탈로그·재고·가격·캠페인 시스템 위에
MerchantBackend를 구현합니다. 모든 쓰기 작업은 사람이 승인하기 전까지 "대기(staged)" 상태로만 남습니다.
스킬 구조가 궁금하다면 Claude Code 스킬 가이드에서 SKILL.md 형식을 확인할 수 있습니다.
사용 전 알아 둘 안전 설계
README는 이 레포가 그대로 운영 환경에 올리는 완제품이 아니라는 점을 분명히 합니다.
- 전부 가상 데이터 — 등장하는 회사·브랜드·제품·인물은 모두 허구이며 유일한 회사명은 ACME입니다.
- 실제 거래 없음 — 어떤 경로에서도 주문·카드 결제·실제 리스팅 변경이 일어나지 않습니다.
checkout은 장바구니를 호스트 앱에 넘겨 렌더링만 하고, 결제는 기존 체크아웃이나 별도 결제 사업자에 맡기는 구조입니다. - 카탈로그 기반 가드레일 — 발표문에 따르면 가격과 상품을 실제 카탈로그 데이터로 제한하고, 조작적인 업셀 패턴을 피하도록 설계돼 있습니다.
- 운영 보안은 도입 측 책임 — 예제에는 인증이 없고 MCP 서버는 로컬(loopback)에만 바인딩됩니다. 비즈니스 규칙·권한·규정 준수는 도입하는 쪽이 추가해야 합니다.
- MCP 커넥터 미동봉 — 외부 시스템 연결은 백엔드 인터페이스를 통해 직접 구현합니다. 분석 웨어하우스·결제·협업 도구는 공식 커넥터가 있으면 그것을 연동 대상으로 삼으라고 안내합니다.
라이선스·유지보수·참고 자료
- 라이선스 — Apache License 2.0(Copyright 2026 Anthropic PBC). 상업적 이용·수정·재배포가 가능한 허용적 라이선스입니다.
- 유지보수 — README는 "참조 구현이며 유지보수되지 않고 기여도 받지 않는다"고 명시합니다. 포크해서 자체적으로 관리하는 전제입니다.
- 발표 수치 — Anthropic은 발표문에서 Claude 기반 쇼핑 에이전트를 운영하는 리테일러가 장바구니 규모 최대 35% 증가, 구매 완료 가능성 60% 증가를 봤다고 밝혔습니다. 자사 고객 사례 기준의 발표 수치이며 독립 검증 자료는 확인되지 않습니다.
- 파트너 구현 — Shopify는 이 청사진을 실제 Shopify 스토어에 연결한 예제 레포(
Shopify/claude-for-commerce-examples)를 별도로 공개했습니다.
공식 자료: GitHub 레포 · 발표문 · 엔지니어링 딥다이브 · 업종별 라이브 데모
추가로 확인할 점
발표문에는 웨비나 등록 안내가 있으나 일정은 등록 페이지에서 직접 확인해야 합니다. 위 성과 수치는 Anthropic 고객 사례 기준이므로 자사 환경에서는 달리 나올 수 있습니다. 또한 레포가 유지보수되지 않는다고 명시돼 있어, 향후 Claude 모델·SDK 변경에 따른 호환성은 사용자가 직접 확인해야 합니다.