Claude Code Integration

Rafter provides TWO skills for Claude Code that separate core scanning functionality from local security operations.

Why Two Skills?

Rafter Security Audits (rafter)

Auto-invocable - Claude can proactively suggest scans

API-based SAST/SCA scanning
Read-only operations
Safe for Claude to auto-invoke
rafter run / rafter scan / rafter get / rafter usage

Agent Security (rafter-agent-security)

User-only - Requires explicit invocation

Local file scanning
Command execution
Skill auditing
Side effects require permission

This architecture emphasizes Rafter’s core backend scanning while keeping local security features behind user control.

Setup

1. Install Rafter CLI

Install globally:

npm install -g @rafter-security/cli

2. Initialize Agent Security

Run initialization (auto-detects Claude Code):

rafter agent init

If Claude Code is detected (checks for ~/.claude/ directory), Rafter will:

✓ Install Backend skill to ~/.claude/skills/rafter/SKILL.md
✓ Install Agent Security skill to ~/.claude/skills/rafter-agent-security/SKILL.md
✓ Enable agent integration in config

Use --skip-claude-code to skip automatic installation, or --claude-code to force installation.

3. Restart Claude Code

Restart your Claude Code session to load the skills:

# Kill existing session
pkill -f claude

# Start new session
claude

Rafter Security Audits: Automated Scanning

The backend skill allows Claude to proactively suggest security scans.

Commands

rafter run

command

Trigger a comprehensive security scan on your repositoryAuto-detects: Current repo and branch from gitExample:

rafter run
rafter scan --repo myorg/myrepo --branch feature-branch

rafter scan is an alias for rafter run.

rafter get

command

Retrieve results from a completed or in-progress scanExample:

rafter get scan_abc123xyz

rafter usage

command

View your API quota and usage statisticsExample:

rafter usage

When Claude Uses It

Claude will automatically invoke backend scanning when you:

Mention “security”, “vulnerabilities”, or “code analysis”
Start working on a new feature
Review a pull request
Update dependencies
Ask about security issues

Example Interactions

Proactive Scan Suggestion

You: “I just updated all the npm packages”Claude: “Let me run a security scan to check for any new vulnerabilities in the updated dependencies.”[Invokes: rafter run]Claude: “Scan complete! Found 2 medium-severity issues in newly updated packages. Here’s what needs attention…”

Pre-PR Security Check

You: “Can you review my changes before I create a PR?”Claude: “I’ll run a security scan on your feature branch first.”[Invokes: rafter run —branch feature-auth]Claude: “Security scan passed with no issues. Your changes look good from a security perspective. Ready to create the PR?”

Quota Check

You: “How many scans do I have left this month?”Claude: [Invokes: rafter usage]Claude: “You’ve used 45 of 100 scans this month. 55 remaining. Your quota resets on March 1st.”

Agent Security Skill: Local Protection

The agent security skill provides local file scanning, command validation, and skill auditing. You must explicitly invoke these commands.

Commands

/rafter-scan

slash-command

Scan files for secrets before commitsExample:

/rafter-scan .
/rafter-scan src/config.ts

Detects: AWS keys, GitHub tokens, Stripe keys, database credentials, private keys (21+ patterns)

/rafter-bash

slash-command

Execute commands with security validationExample:

/rafter-bash "git commit -m 'Add feature'"
/rafter-bash "sudo systemctl restart nginx"

Features:

Blocks destructive commands (rm -rf /, fork bombs)
Requires approval for dangerous operations
Scans staged files before git commits
Logs all command attempts

/rafter-audit-skill

slash-command

Comprehensive security audit of a Claude Code skill before installationExample:

/rafter-audit-skill ~/.claude/skills/untrusted-skill/SKILL.md

Analyzes: 12 security dimensions including network calls, command execution, file access, credential handling, input validation, and more

/rafter-audit

slash-command

View security event logsExample:

/rafter-audit
/rafter-audit --last 20

Events: Command attempts, secret detections, policy overrides, config changes

Usage Examples

Pre-Commit Secret Scan

You: /rafter-scan .Output:

🔍 Scanning 47 files...

⚠️  Found 1 secret:

File: src/config.ts:12
Type: AWS Access Key
Value: AKIA...REDACTED...XYZ
Severity: HIGH

❌ Secrets detected! Do not commit.

Safe Command Execution

You: /rafter-bash "git commit -m 'Add authentication'"Process:

Rafter scans staged files for secrets
If clean: executes commit
If secrets found: blocks and alerts

Output:

✓ No secrets detected in staged files
✓ Command approved: git commit
[main abc123d] Add authentication

Skill Security Audit

You: /rafter-audit-skill ~/.claude/skills/github-integration/SKILL.mdOutput:

# Skill Audit Report

**Skill**: github-integration
**Risk Rating**: MEDIUM

## Findings

### Network Security: ⚠️ Warning
- 3 external URLs found
- https://api.github.com (HTTPS ✓)
- http://internal-api.local (HTTP ⚠️)

### Command Execution: ✓ Pass
- No dangerous commands detected

## Recommendation: ✓ YES (with modifications)

Change http://internal-api.local to HTTPS before installing.

Configuration

Risk Levels

Choose based on your security requirements:

Minimal (Development)

Best for: Local development, prototyping

rafter agent config set agent.riskLevel minimal

Allows most commands
Basic secret detection
Minimal workflow interruption

Moderate (Recommended)

Best for: General use, team environments

rafter agent config set agent.riskLevel moderate

Blocks critical commands
Requires approval for high-risk operations
Secret scanning on all git operations
Default setting

Aggressive (Production)

Best for: Sensitive environments, compliance requirements

rafter agent config set agent.riskLevel aggressive

Maximum security checks
Requires approval for most operations
Comprehensive audit logging

View Current Config

# View all settings
rafter agent config show

# Check specific setting
rafter agent config get agent.riskLevel

Workflows

Secure Development Cycle

Start Feature

You: “Add user authentication”Claude: Writes code, then suggests: “Should I run a security scan?”[Invokes: rafter run]

Pre-Commit Check

You: /rafter-scan .Verify no secrets before committing

Safe Commit

You: /rafter-bash "git commit -m 'Add auth'"Rafter scans and executes if clean

Pre-PR Review

You: “Review my changes”Claude: [Invokes: rafter run —branch feature-auth]“Security scan passed. Ready to create PR?”

Installing Untrusted Skills

Before installing skills from unknown sources:

Download Skill

Save skill file to local directory

Audit Security

You: /rafter-audit-skill /path/to/skill.mdReview comprehensive 12-dimension security analysis

Make Informed Decision

Based on audit findings:

✓ Install if LOW/MEDIUM risk
⚠️ Modify if issues found
❌ Don’t install if HIGH/CRITICAL

Monitoring

View Agent Activity

# Recent command executions
rafter agent audit --event command_intercepted

# Secret detections
rafter agent audit --event secret_detected

# Last 50 events
rafter agent audit --last 50

Audit Reports

Generate compliance reports:

# Export as JSON
rafter agent audit --json > agent-audit.json

# Filter by date
rafter agent audit --since 2026-01-01

Troubleshooting

Skills Not Loading

If Claude doesn’t recognize Rafter skills:

Verify skill files exist:

ls ~/.claude/skills/rafter/SKILL.md
ls ~/.claude/skills/rafter-agent-security/SKILL.md

Reinstall skills:
```
rafter agent init
```
Restart Claude Code session

Backend Skill Not Auto-Invoked

If Claude isn’t suggesting scans automatically:

Check skill is loaded: Look for system reminders showing “rafter” skill
Verify RAFTER_API_KEY is set:
```
echo $RAFTER_API_KEY
```
Try explicit request: “Can you run a Rafter security scan?”

API Key Issues

If backend scans fail:

Set API key:
```
export RAFTER_API_KEY="your-key-here"
```

Or use .env file:

echo "RAFTER_API_KEY=your-key-here" >> .env

Get key from: rafter.so/dashboard

Commands Bypassing Validation

If /rafter-bash isn’t validating:

Check config:

rafter agent config get agent.environments.claudeCode.enabled
# Should return: true

Enable if disabled:

rafter agent config set agent.environments.claudeCode.enabled true

Best Practices

Recommended Workflow

Let Claude auto-scan: Don’t disable the backend skill - proactive scans catch issues early
Scan before commits: Always run /rafter-scan before committing
Audit untrusted skills: Use /rafter-audit-skill for skills from unknown sources
Review audit logs: Check /rafter-audit after suspicious activity
Start with moderate: Adjust risk level based on your needs
Keep CLI updated: npm update -g @rafter-security/cli

Advanced Usage

Pre-Commit Hooks

Automate secret scanning for all commits:

# Install pre-commit hook
rafter agent install-hook

# Install globally (all repos)
rafter agent install-hook --global

This automatically runs /rafter-scan --staged before every commit.

Custom Blocked Patterns

Add organization-specific command patterns: Edit ~/.rafter/config.json:

{
  "agent": {
    "commandPolicy": {
      "blockedPatterns": [
        "kubectl delete namespace production",
        "terraform destroy",
        "rm -rf /important-data"
      ]
    }
  }
}

Skill Auditing Framework

The /rafter-audit-skill command analyzes 12 security dimensions:

Trust & Attribution - Source verification
Network Security - External API calls
Command Execution - Shell commands
File System Access - Read/write operations
Credential Handling - API keys, secrets
Input Validation - Injection risks
Data Exfiltration - Data leaving system
Obfuscation - Hidden behavior
Scope Alignment - Behavior vs purpose
Error Handling - Info leakage
Dependencies - Supply chain risks
Environment Manipulation - System modifications

Each dimension gets a risk rating: ✓ Pass / ⚠️ Warning / ❌ Critical

Comparison: OpenClaw vs Claude Code

Skill Architecture

OpenClaw: Single skill with all featuresClaude Code: Two skills (backend + agent security)Why different? Claude Code’s auto-invocation capability allows separating safe API calls from local operations

Invocation Model

OpenClaw: User or agent invokes all commandsClaude Code:

Backend skill: Auto-invoked by Claude
Agent security: User invokes via slash commands

Command Prefix

OpenClaw: /rafter-scan, /rafter-bash, etc.Claude Code:

Backend: rafter run, rafter get, rafter usage (auto)
Agent: /rafter-scan, /rafter-bash, etc. (manual)

Support

Documentation

Complete guides and API reference

GitHub Issues

Report bugs and request features

Dashboard

Manage API keys and view scan history

Claude Code Docs

Learn more about Claude Code

Next Steps

Command Reference

Complete CLI command documentation

Secret Scanning

Deep dive into secret detection

CI/CD Integration

Use Rafter in continuous integration

API Reference

Backend API documentation

Get Started

CLI Guides

Agent Security

References

​Claude Code Integration

​Why Two Skills?

Rafter Security Audits (rafter)

Agent Security (rafter-agent-security)

​Setup

​1. Install Rafter CLI

​2. Initialize Agent Security

​3. Restart Claude Code

​Rafter Security Audits: Automated Scanning

​Commands

​When Claude Uses It

​Example Interactions

​Agent Security Skill: Local Protection

​Commands

​Usage Examples

​Configuration

​Risk Levels

​View Current Config

​Workflows

​Secure Development Cycle

​Installing Untrusted Skills

​Monitoring

​View Agent Activity

​Audit Reports

​Troubleshooting

​Best Practices

Recommended Workflow

​Advanced Usage

​Pre-Commit Hooks

​Custom Blocked Patterns

​Skill Auditing Framework

​Comparison: OpenClaw vs Claude Code

​Support

Documentation

GitHub Issues

Dashboard

Claude Code Docs

​Next Steps

Command Reference

Secret Scanning

CI/CD Integration

API Reference

Claude Code Integration

Why Two Skills?

Setup

1. Install Rafter CLI

2. Initialize Agent Security

3. Restart Claude Code

Rafter Security Audits: Automated Scanning

Commands

When Claude Uses It

Example Interactions

Agent Security Skill: Local Protection

Commands

Usage Examples

Configuration

Risk Levels

View Current Config

Workflows

Secure Development Cycle

Installing Untrusted Skills

Monitoring

View Agent Activity

Audit Reports

Troubleshooting

Best Practices

Advanced Usage

Pre-Commit Hooks

Custom Blocked Patterns

Skill Auditing Framework

Comparison: OpenClaw vs Claude Code

Support

Next Steps