Settings Components

Settings are configuration presets that customize Claude Code’s behavior, integrations, and workflow. They configure everything from model selection to status line displays.

Browse All Settings

Explore 60+ settings at aitmpl.com

Installation

# Install a single setting
npx claude-code-templates@latest --setting read-only-mode

# Install multiple settings
npx claude-code-templates@latest --setting read-only-mode --setting git/auto-commit

# Install from specific category
npx claude-code-templates@latest --setting mcp/enable-all-project-servers

Setting Categories

MCP Settings

Configure Model Context Protocol servers:

Enable All Project Servers

Enable all MCP servers defined in the project

npx claude-code-templates@latest --setting mcp/enable-all-project-servers

Enable Specific Servers

Enable only selected MCP servers

npx claude-code-templates@latest --setting mcp/enable-specific-servers

Disable Risky Servers

Disable MCP servers with dangerous capabilities

npx claude-code-templates@latest --setting mcp/disable-risky-servers

MCP Timeouts

Configure timeout settings for MCP servers

npx claude-code-templates@latest --setting mcp/mcp-timeouts

Model Settings

Configure AI model selection and behavior:

Default Model

Set default model for Claude Code

npx claude-code-templates@latest --setting model/default

Options:

claude-4.5-sonnet (balanced)
claude-opus (complex tasks)
claude-haiku (fast tasks)

Agent-Specific Models

Configure different models for different agents

npx claude-code-templates@latest --setting model/agent-specific

Git Settings

Configure git workflow automation:

Auto Commit

Automatically commit changes after operations

npx claude-code-templates@latest --setting git/auto-commit

Commit Message Templates

Use templates for commit messages

npx claude-code-templates@latest --setting git/commit-templates

Branch Protection

Configure protected branches

npx claude-code-templates@latest --setting git/branch-protection

Permission Settings

Control Claude Code’s access and capabilities:

Read Only Mode

Restrict Claude to read-only operations

npx claude-code-templates@latest --setting permissions/read-only-mode

Blocks:

File writes and edits
Git commits
Destructive commands

Restricted Bash

Limit bash command execution

npx claude-code-templates@latest --setting permissions/restricted-bash

Allowed Directories

Restrict file access to specific directories

npx claude-code-templates@latest --setting permissions/allowed-directories

Statusline Settings

Customize the status line display:

Git Status

Show git branch and status in statusline

npx claude-code-templates@latest --setting statusline/git-status

Token Counter

Display token usage in statusline

npx claude-code-templates@latest --setting statusline/token-counter

Custom Statusline

Create custom statusline with Python script

npx claude-code-templates@latest --setting statusline/custom

Environment Settings

Configure environment variables and context:

Auto Load .env

Automatically load .env files

npx claude-code-templates@latest --setting environment/auto-load-env

Environment Templates

Use .env templates for different environments

npx claude-code-templates@latest --setting environment/templates

API Settings

Configure API endpoints and keys:

Custom API Endpoint

Use custom Claude API endpoint

npx claude-code-templates@latest --setting api/custom-endpoint

Rate Limiting

Configure API rate limiting

npx claude-code-templates@latest --setting api/rate-limiting

Telemetry Settings

Control analytics and telemetry:

Disable Telemetry

Disable all telemetry collection

npx claude-code-templates@latest --setting telemetry/disable

Anonymous Analytics

Enable anonymous usage analytics

npx claude-code-templates@latest --setting telemetry/anonymous

Cleanup Settings

Automatic cleanup and maintenance:

Auto Cleanup

Automatically clean temporary files

npx claude-code-templates@latest --setting cleanup/auto-cleanup

Log Rotation

Rotate and archive logs

npx claude-code-templates@latest --setting cleanup/log-rotation

Global Settings

System-wide configurations:

Editor Integration

Configure editor integration settings

npx claude-code-templates@latest --setting global/editor-integration

Workspace Defaults

Set default workspace configurations

npx claude-code-templates@latest --setting global/workspace-defaults

Settings Configuration

Settings are stored in .claude/settings/ and .claude/config/:

{
  "name": "read-only-mode",
  "description": "Restrict Claude to read-only operations",
  "config": {
    "permissions": {
      "allowWrite": false,
      "allowBash": false,
      "allowGit": false
    }
  }
}

Statusline with Python

Custom statuslines can use Python scripts:

# .claude/scripts/git-status.py
import subprocess

def get_git_status():
    branch = subprocess.check_output(['git', 'branch', '--show-current'])
    status = subprocess.check_output(['git', 'status', '--short'])
    return f"{branch.strip()} | {len(status.splitlines())} changes"

print(get_git_status())

Setting Priorities

Settings are applied in order:

Global settings: System-wide defaults
Project settings: Project-specific configs
User settings: User overrides
Runtime settings: Temporary overrides

Example Usage

# Enable read-only mode for safety
npx claude-code-templates@latest --setting read-only-mode

# Claude can now only read files, not modify them
# To disable, remove .claude/settings/read-only-mode.json

Combining Settings

Install multiple related settings:

# Security-focused configuration
npx claude-code-templates@latest \
  --setting permissions/read-only-mode \
  --setting mcp/disable-risky-servers \
  --setting git/branch-protection

Temporary Settings

Some settings can be overridden temporarily:

# In Claude Code, use environment variables
export CLAUDE_ALLOW_WRITE=true

​Settings Components

Browse All Settings

​Installation

​Setting Categories

​MCP Settings