Claude Code Settings

This repository contains local settings configuration for Claude Code, optimized for software development workflows.

Overview

The settings.local.json file defines permissions for Claude Code to execute various commands and access specific files without requiring manual approval for each operation.

Configuration Structure

The settings file uses a permission-based system with three categories:

• allow: Commands and file access that are automatically permitted
• deny: Commands and file access that are automatically blocked
• ask: Commands and file access that require user confirmation

Allowed Operations

Package Managers

npm (Node Package Manager)

• npm run * - Execute any npm script defined in package.json
• npm install * - Install npm packages
• npm ci - Clean install from package-lock.json

Alternative Package Managers

• npx * - Execute npm packages without installation
• yarn * - Yarn package manager commands
• pnpm * - PNPM package manager commands

Programming Languages & Runtimes

JavaScript/TypeScript

• node * - Execute Node.js scripts
• deno * - Deno runtime commands
• bun * - Bun runtime commands
• tsc * - TypeScript compiler

Python

• python * - Execute Python 2.x scripts
• python3 * - Execute Python 3.x scripts
• pip * - Python package installer

Other Languages

• cargo * - Rust package manager and build tool
• go * - Go programming language toolchain
• mvn * - Apache Maven (Java)
• gradle * - Gradle build automation (Java/Kotlin)

Version Control (Git)

Repository Information

• git status - Check working tree status
• git log * - View commit history
• git diff * - Show changes between commits
• git branch * - List, create, or delete branches

Branch Management

• git checkout * - Switch branches or restore files
• git merge * - Merge branches
• git rebase * - Reapply commits on top of another base

Changes Management

• git add * - Stage changes for commit
• git commit * - Record changes to repository
• git stash * - Temporarily store modified files
• git reset * - Undo changes
• git restore * - Restore working tree files

Remote Operations

• git push * - Upload local changes to remote
• git pull * - Fetch and integrate remote changes
• git fetch * - Download objects from remote

Docker & Containers

Container Management

• docker ps * - List containers
• docker images * - List images
• docker logs * - View container logs
• docker exec * - Execute commands in containers

Docker Compose

• docker compose * - Docker Compose V2 commands
• docker-compose * - Docker Compose V1 commands

Testing & Code Quality

JavaScript/TypeScript Testing

• jest * - Jest testing framework
• vitest * - Vite-powered test runner

Python Testing

• pytest * - Python testing framework

Code Quality

• eslint * - JavaScript/TypeScript linter
• prettier * - Code formatter

DevOps & Infrastructure

Infrastructure as Code

• terraform * - Terraform infrastructure management

Kubernetes

• kubectl * - Kubernetes command-line tool
• helm * - Kubernetes package manager

Build Tools

• make * - GNU Make build automation

System Monitoring & Network

Process Management

• kill * - Terminate processes by PID
• killall * - Terminate processes by name
• ps aux * - Display running processes
• lsof * - List open files and network connections

Network Utilities

• netstat * - Network statistics and connections
• ss * - Socket statistics (modern netstat alternative)
• curl * - Transfer data from/to servers
• wget * - Download files from the web

File Access

Configuration Files

• ~/.zshrc - Zsh shell configuration
• ~/.bashrc - Bash shell configuration
• ~/.gitconfig - Git global configuration
• /etc/hosts - System hosts file

Usage

1. Place settings.local.json in your project root or Claude Code configuration directory
2. Claude Code will automatically load these permissions
3. Commands matching the allowed patterns will execute without prompting for approval

Security Considerations

• Review allowed commands periodically to ensure they align with your security requirements
• Use wildcards (*) carefully as they grant broad permissions
• Consider using the ask category for sensitive operations that should require confirmation
• The deny category can be used to explicitly block specific commands

Customization

To customize these settings:

1. Add new patterns to the allow array for commands you frequently use
2. Move sensitive commands to the ask array if you want manual approval
3. Add patterns to the deny array to block specific operations
4. Use specific patterns instead of wildcards for tighter security

Pattern Syntax

• Bash(command) - Allows exact bash command
• Bash(command *) - Allows command with any arguments
• Bash(command:*) - Allows command with colon-separated arguments
• Read(filepath) - Allows reading specific file

Example Workflows

Web Development

npm install express
npm run dev
git add .
git commit -m "Add express server"
docker compose up

Python Development

pip install requests
python3 script.py
pytest tests/
git push origin main

DevOps Operations

kubectl get pods
terraform apply
docker logs container-name
helm upgrade release-name chart/

All these commands will execute automatically without requiring manual approval.

Contributing

Feel free to extend this configuration based on your development workflow needs. Common additions include:

• Database CLI tools (psql, mysql, mongo)
• Cloud provider CLIs (aws, gcloud, az)
• Additional build tools and task runners
• Development servers and hot-reload tools

License

This configuration is provided as-is for development convenience. Adjust permissions according to your security policies and requirements.