Claude Code Setup Guide
Complete guide to integrating Bootspring with Claude Code (Anthropic's CLI coding assistant).
Overview#
Claude Code is Anthropic's terminal-based AI coding assistant. Bootspring enhances Claude Code by providing:
- Structured Context - CLAUDE.md provides project understanding
- MCP Integration - Access Bootspring tools directly
- Expert Agents - Specialized AI assistance
- Development Workflows - Guided multi-phase development
Prerequisites#
- Claude Code installed
- Bootspring CLI installed (
npm install -g bootspring) - Node.js 18+ installed
- Bootspring account (optional)
Installing Claude Code#
macOS#
Windows#
Linux#
Authenticate#
Bootspring + Claude Code Integration#
Method 1: CLAUDE.md Context (Recommended)#
Claude Code automatically reads CLAUDE.md files in your project.
Generate context:
Verify:
Now Claude Code has full project understanding.
Method 2: MCP Server#
Configure Bootspring as an MCP server for Claude Code.
Add to ~/.claude/mcp.json:
Or use CLI:
Method 3: Project Configuration#
Add to .claude directory in your project:
Create .claude/settings.json:
Using Bootspring with Claude Code#
Context-Aware Assistance#
Claude Code reads your CLAUDE.md automatically:
Invoking Agents via Chat#
Ask Claude Code to use Bootspring agents:
> Use the bootspring security-expert to review my authentication implementation
Applying Skills#
Request skill patterns:
> Apply the bootspring api-endpoint pattern for a user profile endpoint
Running Workflows#
Start development workflows:
> Start the bootspring feature-development workflow for adding notifications
Command Integration#
Bootspring Commands in Claude Code#
Run Bootspring commands directly:
Slash Commands#
Create custom slash commands in .claude/commands.json:
Usage:
/bs-generate
/bs-agent frontend-expert "Create a form component"
/bs-skill patterns/react-form
Configuration Files#
Project Context#
CLAUDE.md (generated by Bootspring):
Bootspring Config#
bootspring.config.js:
Claude Code Settings#
~/.claude/settings.json (global):
Workflow Examples#
Feature Development#
Code Review#
Quick Fixes#
Context Synchronization#
Auto-Refresh#
Keep context updated:
Manual Refresh#
Watch Mode#
MCP Tools Available#
When configured as MCP server, these tools are available:
| Tool | Description |
|---|---|
bootspring_context | Get project context |
bootspring_agent | Invoke expert agents |
bootspring_skill | Apply skill patterns |
bootspring_workflow | Start workflows |
bootspring_generate | Regenerate context |
bootspring_quality | Run quality checks |
bootspring_todo | Manage tasks |
Using MCP Tools#
> Use bootspring_context to understand this codebase
> Use bootspring_agent database-expert to design the schema
> Use bootspring_skill patterns/prisma-crud for the User model
Performance Tips#
Optimize Context Size#
Cache Configuration#
Troubleshooting#
Context Not Loading#
MCP Connection Issues#
Agent Invocation Failures#
Slow Context Generation#
Security#
API Key Management#
Environment variable (recommended):
In MCP config:
File Permissions#
Sensitive Data#
Exclude sensitive files from context:
Integration with Other Tools#
VS Code + Claude Code#
Use both together:
- VS Code for editing
- Claude Code for AI assistance
- Bootspring for context and patterns
Git Hooks#
Pre-commit quality check: