jiten-singh-shahi/configure-scc

Configure SCC

Interactive guide for installing and configuring Salesforce Claude Code.

When to Use

• When installing SCC for the first time on a Salesforce project
• When adding new modules or profiles to an existing SCC installation
• When customizing hook behavior or profiles for your team's workflow
• When troubleshooting SCC configuration or missing components
• When setting up SCC for different team members or CI/CD environments

Installation

Quick Install

# Install globally
npm install -g scc-universal

# Install with a profile
npx scc-universal install all      # Everything (all agents, skills, rules)
npx scc-universal install apex     # Apex-focused development
npx scc-universal install lwc      # LWC-focused development

Profile Details

| Profile | Includes | |---------|----------| | apex | Common rules + Apex rules, agents, skills | | lwc | Common rules + LWC rules, agents, skills | | full | All agents, skills, rules |

Diagnostics

npx scc-universal doctor    # Check for missing/drifted files
npx scc-universal status    # View installed components
npx scc-universal repair    # Restore drifted files
npx scc-universal uninstall # Remove SCC-managed files

Hook Configuration

Profiles

# Set hook profile (controls which hooks run)
export SCC_HOOK_PROFILE=minimal    # Session start + stop only
export SCC_HOOK_PROFILE=standard   # Default — includes quality checks
export SCC_HOOK_PROFILE=strict     # All hooks including auto-format

Disable Specific Hooks

export SCC_DISABLED_HOOKS=governor-check,cost-tracker

Package Manager

SCC auto-detects your package manager. Override with:

export CLAUDE_PACKAGE_MANAGER=npm  # or pnpm, yarn, bun

Environment-Specific Configuration

Sandbox / Scratch Org Development

# Set default target org for SF CLI commands
sf config set target-org=my-scratch-org

# Scratch org duration is set via --duration-days flag or scratch org definition file
# sf org create scratch -f config/project-scratch-def.json --duration-days 7

CI/CD Environments

# Minimal hooks for CI (fast, no interactive prompts)
export SCC_HOOK_PROFILE=minimal

# Disable all cost/session tracking in CI
export SCC_DISABLED_HOOKS=cost-tracker,session-start,session-end,evaluate-session

Team Setup

Share SCC configuration across your team by adding to your project's .env.example:

# .env.example — copy to .env and customize
SCC_HOOK_PROFILE=standard
CLAUDE_PACKAGE_MANAGER=npm

Troubleshooting

Common Issues

| Problem | Cause | Fix | |---------|-------|-----| | npx scc-universal install fails | Node.js < 20 | Upgrade: nvm install 20 | | Hooks not firing | SCC not installed in project | Run npx scc-universal doctor to check | | Permission denied on hooks | Script not executable | Run npx scc-universal repair | | Skills not loading | Wrong install profile | Run npx scc-universal install all | | sf command not found | SF CLI not installed | Install: npm install -g @salesforce/cli | | sf commands fail with errors | SF CLI version too old | Upgrade: npm update -g @salesforce/cli (SCC requires SF CLI v2.x / sf not sfdx) | | Hooks slow down session | Too many hooks enabled | Switch to SCC_HOOK_PROFILE=minimal |

Diagnostic Commands

# Full diagnostic report
npx scc-universal doctor

# See exactly what's installed
npx scc-universal list-installed

# Preview what WOULD be installed (dry run)
npx scc-universal plan apex

# Check state store
npx scc-universal status

# Reset everything and reinstall
npx scc-universal uninstall && npx scc-universal install all

Upgrading SCC

# Update to latest version
npm install -g scc-universal@latest

# Repair any drifted files after upgrade
npx scc-universal repair

# Verify upgrade
npx scc-universal doctor

Verification

npm test              # Run all validators
npx scc-universal doctor        # Check installation health
sf --version          # Verify SF CLI is installed
npx scc-universal status        # Confirm installed components