headless-checkout-proxy — скилл для Claude Code: обзор и установка
Направляет агента при сборке чекаута и корзины VTEX через BFF-сервер. Помогает безопасно проксировать OrderForm и соблюдать правила PCI DSS.
npx skills add vtex/skills --skill headless-checkout-proxy -a claude-codeЧто делает headless-checkout-proxy
Скилл задаёт строгие архитектурные рамки для headless-магазинов на платформе VTEX. Все операции с корзиной и чекаутом (/api/checkout/...) агент обязан проводить исключительно через серверный слой BFF. Хранить orderFormId во фронтенд-хранилищах вроде localStorage запрещено. Идентификатор и сессионные куки CheckoutOrderFormOwnership должны оставаться на сервере.
Для оформления заказа скилл предписывает трёхэтапную схему: создание заказа, отправку платежа и финализацию. При этом платёжные реквизиты категорически нельзя пускать через BFF. Браузер должен отправлять карточные данные напрямую в шлюз vtexpayments.com.br, чтобы сервер магазина не подпадал под расширенную сертификацию PCI DSS.
Промежуточные параметры вроде orderGroup передаются строго через тело запроса, а не сессию Express. На нескольких репликах BFF локальная память пода теряется. Передача значений в теле запроса спасает от ложных ошибок 400 при потере контекста.
Какие задачи решает
- изолировать Checkout API VTEX от прямых вызовов из браузера
- настроить хранение orderFormId и кук в серверной сессии
- организовать передачу карт в vtexpayments.com.br по правилам PCI DSS
- передавать orderGroup между шагами чекаута без сбоев на репликах BFF
Примеры запросов агенту
- Спроектируй эндпоинт добавления товара в корзину VTEX через наш BFF
- Настрой трёхшаговое оформление заказа с отправкой карт напрямую в платёжный шлюз
- Покажи, как проксировать привязку адреса доставки к OrderForm
Как установить headless-checkout-proxy
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-checkout-proxy -a claude-code2Вручную: положить файлы
~/.claude/skills/headless-checkout-proxy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/headless-checkout-proxy/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-checkout-proxy -a codex2Вручную: положить файлы
.agents/skills/headless-checkout-proxy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-checkout-proxy -a cursor2Вручную: положить файлы
.cursor/skills/headless-checkout-proxy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills headless-checkout-proxy2Вручную: положить файлы
.github/skills/headless-checkout-proxy/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-checkout-proxy -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/headless-checkout-proxyВручную: положить файлы
.devin/skills/headless-checkout-proxy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-checkout-proxy -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о headless-checkout-proxy
Как установить headless-checkout-proxy в Claude Code?
Выполните команду npx skills add vtex/skills --skill headless-checkout-proxy -a claude-code. Конфигурация запишется в ~/.claude/skills/headless-checkout-proxy/SKILL.md.
Что делает headless-checkout-proxy?
Скилл координирует генерацию кода для корзины и чекаута VTEX через промежуточный сервер BFF. Он контролирует жизненный цикл OrderForm, серверные куки сессий и соблюдение изоляции карточных данных.
Почему карточные платежи идут мимо BFF?
По требованию стандарта PCI данные карт не должны проходить через сервер продавца. Фронтенд отправляет запрос на оплату прямо в vtexpayments.com.br, а BFF выполняет только шаги инициации и подтверждения заказа.
