Claude Code Configuration

Personal Claude Code configuration files for synchronizing settings, custom commands, and rulesets across multiple machines.

Contents

• CLAUDE.md - Personal ruleset with preferences and patterns that apply to all projects
• commands/ - Custom slash commands for Claude Code
  • commit.md - Enhanced git commit workflow
  • optimize-ruleset.md - Ruleset optimization and analysis
• COMMANDS-QUICKSTART.md - Documentation for using custom commands
• settings.json - Claude Code global settings

Installation

Initial Setup (New Machine)

1. Clone this repository:

   git clone https://github.com/YOUR-USERNAME/claude-code-config.git ~/claude-code-config-temp
   

2. Run the setup script:

   cd ~/claude-code-config-temp
   ./setup.sh
   

   Or manually:

   # Backup existing .claude directory if it exists
   mv ~/.claude ~/.claude.backup.$(date +%Y%m%d-%H%M%S)
   
   # Copy configuration files
   mkdir -p ~/.claude
   cp -r ~/claude-code-config-temp/* ~/.claude/
   
   # Clean up
   rm -rf ~/claude-code-config-temp
   

3. Verify installation:

   ls -la ~/.claude
   

Updating Configuration

To pull the latest changes on any machine:

cd ~/.claude
git pull origin main

Pushing Changes

After making changes to your configuration:

cd ~/.claude
git add CLAUDE.md commands/ settings.json COMMANDS-QUICKSTART.md
git commit -m "Update configuration"
git push origin main

File Structure

.claude/
├── .gitignore              # Protects sensitive files
├── README.md               # This file
├── CLAUDE.md               # Personal ruleset (global)
├── COMMANDS-QUICKSTART.md  # Command documentation
├── settings.json           # Claude Code settings
└── commands/               # Custom slash commands
    ├── commit.md
    ├── optimize-ruleset.md
    └── README.md

Excluded from Version Control

The following files/directories are automatically excluded via .gitignore:

• .credentials.json - API credentials (sensitive)
• history.jsonl - Session history
• file-history/ - File version history
• projects/ - Project-specific session data
• todos/ - Session todos
• debug/ - Debug logs
• shell-snapshots/ - Temporary shell snapshots
• statsig/ - Analytics data
• ide/ - IDE state files

Usage

Personal Ruleset

The CLAUDE.md file contains your personal preferences that apply to ALL Claude Code sessions. It includes:

• Communication style preferences
• Code quality standards
• Tool usage patterns
• Python project conventions
• Git workflow preferences
• Todo list management guidelines

Important: This personal ruleset is overridden by project-specific rulesets (.claude/CLAUDE.md in project directories).

Custom Commands

Available custom slash commands:

• /commit [push] - Create logical git commits with optional push
• /optimize-ruleset - Analyze and optimize CLAUDE.md ruleset files

See COMMANDS-QUICKSTART.md for detailed usage instructions.

Best Practices

Before Committing Changes

1. Review your changes:

   cd ~/.claude
   git status
   git diff
   

2. Ensure no sensitive data:

   • Check that .credentials.json is not staged
   • Verify no API keys or secrets are in committed files

3. Test on current machine:

   • Restart Claude Code session
   • Verify ruleset is applied correctly
   • Test custom commands

Syncing Across Machines

1. Machine A (make changes):

   cd ~/.claude
   git add -A
   git commit -m "Update ruleset: description of changes"
   git push
   

2. Machine B (pull changes):

   cd ~/.claude
   git pull
   

3. Verify sync:

   • Check that files match
   • Restart Claude Code if needed

Troubleshooting

Git says directory is not a repository

cd ~/.claude
git init
git remote add origin https://github.com/YOUR-USERNAME/claude-code-config.git
git fetch
git checkout main

Changes not being applied

• Restart Claude Code session
• Check file permissions: ls -la ~/.claude
• Verify file contents match repository

Accidentally committed sensitive data

1. Remove from history:

   git filter-branch --force --index-filter \
     "git rm --cached --ignore-unmatch .credentials.json" \
     --prune-empty --tag-name-filter cat -- --all
   

2. Force push (CAUTION):

   git push origin --force --all
   

3. Rotate compromised credentials immediately

Contributing

This is a personal configuration repository. If you're setting up your own:

1. Fork or create your own repository
2. Update YOUR-USERNAME in this README
3. Customize CLAUDE.md with your preferences
4. Add your own custom commands

Security Notes

• NEVER commit .credentials.json or any files with API keys
• The .gitignore is configured to prevent common sensitive files
• Review all changes before pushing
• Use private repository if it contains any identifying information

License

Personal configuration - use as you see fit for your own Claude Code setup.

Related Resources

• Claude Code Documentation
• Writing Custom Commands
• CLAUDE.md Ruleset Guide