Skip to main content
Use the Sparkle CLI to connect Claude Code to the Sparkle MCP server, hooks, and guardrail rules.

​
Prerequisites

Before you set up Claude Code, make sure you have:

​
Set up Claude Code

1

Sign in

Authenticate with Sparkle via browser OAuth:
sparkle login
Your session is stored locally under ~/.sparkle/.
2

Configure Claude Code

Wire Claude Code to Sparkle:
sparkle setup --ide claudeCode
This connects Claude Code to the Sparkle MCP server, configure sparkle hooks, and registers guardrail rules for your machine.
3

Verify status

Confirm you are logged in and Claude Code is configured:
sparkle status

​
Verify guardrails

1

Open a project

Open the repository you want to protect with Sparkle in Claude Code.
2

Run a prompt

Use Claude Code in that project. Sparkle applies guardrails on every prompt before code generation.

​
What setup configures

When you run sparkle setup, the CLI:
  • Connects Claude Code to the Sparkle MCP server
  • Installs and wires up hooks
  • Registers guardrail rules for your workspace

​
Remove configuration

To remove Sparkle configuration from Claude Code only: 
sparkle logout --ide claudeCode

​
Next steps

Using the CLI

Learn the full CLI workflow.

Commands

Full command reference with options.