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 say 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.

Get your computer ready

1. Install Claude Code.
2. Install Node.js 24 or later.
3. Install pnpm.
4. Install Git.

The plugin checks for these three tools before it creates the project, and gives you an install link if one is missing.

Install the plugin

1. Open Claude Code.
2. Enter the command to add EcomWeb’s plugin repository.
3. Enter the command to install the plugin.

$ /plugin marketplace add ecomwebai/ecomweb-claude-plugin
$ /plugin install ecomweb@ecomweb

Create a project for your store

1. In Claude Code, enter /ecomweb:new. You can add your store ref after the command, 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.
4. Click Approve.
5. If you have several stores, tell Claude which store to use.
6. When Claude asks where to create the project, choose to create it on this computer.

Only the store owner can create a project, because the command needs the store’s publishable key. Claude creates the project folder and installs the packages it needs. If you do not have a store yet, Claude asks for a name and creates a new store.

Run and open the project

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

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

Ask Claude to build your theme

1. Copy the prompt below.
2. Paste it into Claude Code, opened in the project folder.
3. Replace the part in square brackets with what you want.
4. Send the prompt.

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

Check and update the project

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

Put the code on your store

When you are happy with it, run the project on your own server, then connect a theme to that website. This works on every plan. See Connect a self-hosted site.

Frequently asked questions