Skip to main content
How-to

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

  1. Run uc-storefront skills status. It should list the .claude/skills copy with no missing or edited files.
  2. Start Claude Code from inside the workspace folder (the one with ultracart.json).
  3. 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
  1. The first command prints a URL and a code and exits at once. Claude Code relays both to you.
  2. You open the URL in your own browser, check the code, and approve.
  3. The second command waits up to 45 seconds. It exits 0 once you have approved and 3 while the sign-in is still waiting, so Claude Code runs it again until it exits 0.

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 codex or --target gemini has no copy Claude Code reads.
  • Updating the CLI does not update the skill. After npm install -g @ultracart/storefront-cli@beta, run uc-storefront skills install in 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​

Was this page helpful?