Skip to content

Build your store with Claude Code

The EcomWeb plugin for Claude Code creates a storefront project on your computer that is linked to your store, then lets Claude build and edit your theme using your real store data. You describe what you want, and Claude edits the code and checks it.

Every change stays on your computer. Customers see nothing until you put the code on your store yourself. You need to be the store owner, because creating the project reads the store’s publishable key.

Install Claude Code, Node.js 24 or later, pnpm and Git. /ecomweb:new checks the last three before it creates the project, and gives an install link for any that is missing.

In Claude Code, add EcomWeb’s plugin repository, then install the plugin.

/plugin marketplace add ecomwebai/ecomweb-claude-plugin
/plugin install ecomweb@ecomweb
  1. In Claude Code, enter /ecomweb:new. You can add your store ref, for example /ecomweb:new <store ref>.
  2. Open the sign-in link Claude gives you.
  3. On the Sign in to ecomweb CLI? page, check that the Code matches the code Claude shows, then click Approve.
  4. If you have several stores, tell Claude which one to use. If you have none, Claude asks for a name and creates one.
  5. When Claude asks where to create the project, choose this computer or a new private GitHub repository.

Claude creates the project folder and installs its packages. It does not start the dev server.

  1. Open a terminal in the new project folder and run pnpm dev.
  2. Open http://localhost:3002 to see the storefront with your store data.
  3. Quit Claude Code, then run claude in the project folder.

Start Claude Code inside the project folder so it loads the project’s own instructions. They teach Claude the storefront kit, your real store data and when a page counts as done.

Replace the part in square brackets with what you want, then send the prompt in Claude Code, opened in the project folder.

Prompt for Claude Code
In this storefront project, [for example: build the home page from my best-selling products, using my brand colors].
Only edit code on this computer. When you are done, run pnpm check and tell me which page to open to see it.
Do not deploy and do not publish the theme, I will do that myself.

See the result at http://localhost:3002, then tell Claude what else to change.

# Run pnpm check, then review the pages against the quality checklist
/ecomweb:check
# Update the project's skill, storefront-kit and SDK, then run pnpm check
/ecomweb:update

Both commands only work inside a storefront project, which is a folder with an .ecomweb.json file.

When you are happy with the result, run the project on your own server and connect a theme to that website. See the self-hosted site guide and the theme code guide.

Will Claude ask for my API key or password?

Section titled “Will Claude ask for my API key or password?”

No. You approve the sign-in in your own browser. The plugin tells Claude never to ask for codes, keys or tokens, and never to write them into files.

Yes, but not through the plugin. Run npx @ecomweb/cli storefront init to create the project, then open that folder in Codex. The project has an AGENTS.md file that points to the same instructions.

Claude Code installs the plugin straight from its GitHub repository, so you get new versions through Claude Code’s plugin update. /ecomweb:update only updates the storefront project.