Use the StoreFront CLI with Claude Code
Claude Code is Anthropic's coding agent for the terminal. It reads project skills from the workspace's .claude/skills/ folder. Status: Supported.
Prerequisites
- Node.js 24 or newer, with npm (
node -v). - Claude Code installed and signed in.
- An UltraCart account whose user has StoreFront access.
Install the CLI and the skill
npm install -g @ultracart/storefront-cli@beta
uc-storefront --version
uc-storefront init my-storefront --target claude
cd my-storefront
uc-storefront skills status
When Claude Code runs init for you, its shell cannot answer prompts. Have it add --no-input:
uc-storefront init my-storefront --target claude --no-input
If you also use Codex or Google Antigravity in the same workspace, repeat the flag: --target claude --target codex.
Confirm Claude Code sees the skill
The skill lands in my-storefront/.claude/skills/build-ultracart-storefronts/.
- Run
uc-storefront skills status. It should list the.claude/skillscopy with no missing or edited files. - Start Claude Code from inside the workspace folder (the one with
ultracart.json). - Ask it to list its skills and look for
build-ultracart-storefronts.
If it is missing, restart the session from the workspace folder. If the copy is missing, add it with uc-storefront skills install --target claude. See The agent does not list the skill.
Sign in
On a desktop, the sign-in goes into the operating system's keychain and no key is needed.
You can sign in yourself in a terminal:
uc-storefront profile create my-store
uc-storefront auth login --profile my-store
uc-storefront profile bind my-store
uc-storefront sf storefronts
When Claude Code runs the sign-in, its command tool shows output only when a command exits, so it signs in in two steps:
uc-storefront auth login --profile my-store --no-wait
uc-storefront auth login --profile my-store --continue --wait
- The first command prints a URL and a code and exits at once. Claude Code relays both to you.
- You open the URL in your own browser, check the code, and approve.
- The second command waits up to 45 seconds. It exits
0once you have approved and3while the sign-in is still waiting, so Claude Code runs it again until it exits0.
Then bind the workspace with uc-storefront profile bind my-store.
Running Claude Code in a container
A container usually has no keychain. uc-storefront auth status then shows credential store: encrypted-file, and the sign-in needs a credential key that you put in the container's secrets. Follow Docker, Fly.io and CI runners for the key and the persistent configuration folder, then sign in with the two-step flow above.
Caveats
- Claude Code reads
.claude/skills/, not.agents/skills/. A workspace set up only with--target codexor--target geminihas no copy Claude Code reads. - Updating the CLI does not update the skill. After
npm install -g @ultracart/storefront-cli@beta, runuc-storefront skills installin each workspace. - Never paste a password, API key, token or credential key into the Claude Code chat. You approve the sign-in in your browser.
Next steps
- Connect your store: profiles, binding and how long a sign-in lasts
- Safety and human approval: read before the first live change
- What it can do: the areas Claude Code can work on with the skill