Claude Code Settings全字段调优实战：五层配置体系从入门到精通

{
  "$schema": "https://json-schema.org/claude-code-settings.json",
  ...
}

{
  "model": "claude-sonnet-4-5-20250929",
  "smallModel": "claude-haiku-4-5-20251001"
}

{
  "thinkingDepth": "high"
}

{
  "autoCompact": true
}

{
  "statusLine": {
    "enabled": true,
    "showTokenCount": true,
    "showCost": true,
    "showModel": true
  }
}

{
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git *)", "Read(*)", "Edit(*)"],
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)", "Bash(rm -rf *)"],
    "defaultMode": "plan",
    "additionalDirectories": ["/path/to/shared/repo"]
  }
}

{
  "permissions": {
    "additionalDirectories": [
      "/home/user/shared-libs",
      "/opt/common-configs"
    ]
  }
}

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxx",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-4-5-20251001",
    "NODE_ENV": "development",
    "DATABASE_URL": "postgresql://localhost:5432/dev"
  }
}

{
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false,
    "allowedCommands": ["git", "node", "npm", "python3"],
    "allowedDomains": ["github.com", "registry.npmjs.org"],
    "networkDisabled": false
  }
}

{
  "attribution": {
    "commit": "🤖 Generated with Claude Code\n\nCo-Authored-By: Claude <[email protected]>",
    "pr": "Generated with [Claude Code](https://claude.com/claude-code)"
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo 'Executing: $TOOL_INPUT' >> /tmp/claude-audit.log"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit",
        "command": "npx prettier --write $FILE_PATH"
      }
    ],
    "Notification": [
      {
        "command": "curl -X POST https://hooks.slack.com/services/xxx -d '{\"text\": \"Claude Code task completed\"}'"
      }
    ],
    "Stop": [
      {
        "command": "osascript -e 'display notification \"Claude Code finished\" with title \"Task Done\"'"
      }
    ]
  },
  "disableAllHooks": false,
  "allowManagedHooksOnly": false
}

{
  "enableAllProjectMcpServers": true,
  "enabledMcpjsonServers": ["memory", "github", "filesystem"],
  "disabledMcpjsonServers": ["dangerous-tool"]
}

{
  "allowedMcpServers": [{"serverName": "github"}],
  "deniedMcpServers": [{"serverName": "filesystem"}]
}

{
  "enabledPlugins": {
    "formatter@acme-tools": true,
    "linter@acme-tools": false
  },
  "extraKnownMarketplaces": [
    {
      "source": "github",
      "repo": "my-org/claude-plugins"
    }
  ]
}

{
  "apiProvider": "anthropic",
  "apiKeyHelper": "/path/to/token-refresh-script.sh"
}

claude --model claude-opus-4-6

{
  "$schema": "https://json-schema.org/claude-code-settings.json",
  "model": "claude-sonnet-4-5-20250929",
  "smallModel": "claude-haiku-4-5-20251001",
  "defaultMode": "autoEdit",
  "autoCompact": true,
  "thinkingDepth": "medium",
  "language": "zh-CN",
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm run *)",
      "Bash(npx *)",
      "Read(*)",
      "Edit(*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Bash(rm -rf *)"
    ]
  },
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "true"
  },
  "attribution": {
    "commit": "Co-Authored-By: Claude <[email protected]>"
  }
}

{
  "$schema": "https://json-schema.org/claude-code-settings.json",
  "defaultMode": "autoEdit",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test*)",
      "Bash(npm run build*)",
      "Bash(git status)",
      "Bash(git diff*)",
      "Bash(git log*)",
      "Read(*)",
      "Edit(*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(~/.ssh/**)",
      "Bash(rm -rf *)",
      "Bash(curl *)",
      "Bash(wget *)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "command": "npx prettier --write $FILE_PATH 2>/dev/null || true"
      }
    ],
    "Stop": [
      {
        "command": "npm run lint --silent 2>/dev/null || true"
      }
    ]
  },
  "attribution": {
    "commit": "Co-Authored-By: Claude <[email protected]>",
    "pr": "Generated with [Claude Code](https://claude.com/claude-code)"
  }
}

{
  "$schema": "https://json-schema.org/claude-code-settings.json",
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(~/.ssh/**)",
      "Read(~/.aws/**)",
      "Bash(rm -rf *)",
      "Bash(curl * | *)",
      "Bash(wget *)",
      "Bash(docker rm *)",
      "Bash(kubectl delete *)"
    ]
  },
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false,
    "allowedDomains": [
      "github.com",
      "registry.npmjs.org",
      "pypi.org"
    ]
  },
  "allowManagedHooksOnly": true,
  "allowManagedPermissionRulesOnly": true,
  "disableAllHooks": false,
  "allowedMcpServers": [
    {"serverName": "github"},
    {"serverName": "memory"}
  ],
  "deniedMcpServers": [
    {"serverName": "filesystem"},
    {"serverName": "browser"}
  ],
  "strictKnownMarketplaces": [
    {
      "source": "github",
      "repo": "company-approved/claude-plugins"
    }
  ]
}

mkdir -p .claude

python3 -c "import json; json.load(open('.claude/settings.json'))"

"allow": ["npm test"]

"allow": ["Bash(npm test)"]

.claude/settings.local.json
.claude/CLAUDE.local.md

"env": {
  "SOME_FLAG": true
}

"env": {
  "SOME_FLAG": "true"
}

{
  "model": "claude-sonnet-4-5-20250929",
  "smallModel": "claude-haiku-4-5-20251001",
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-4-5-20251001"
  }
}

{
  "apiProvider": "bedrock",
  "env": {
    "AWS_REGION": "us-east-1"
  }
}

{
  "apiProvider": "vertex",
  "env": {
    "ANTHROPIC_VERTEX_PROJECT_ID": "my-project",
    "ANTHROPIC_VERTEX_REGION": "us-central1"
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\" 2>/dev/null || true"
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo \"[$(date '+%Y-%m-%d %H:%M:%S')] $CLAUDE_TOOL_INPUT\" >> /var/log/claude-audit.log"
      }
    ]
  }
}

{
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "true"
  },
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false,
    "networkDisabled": true
  },
  "permissions": {
    "deny": [
      "WebFetch(*)",
      "Read(./.env*)",
      "Read(~/.ssh/**)",
      "Bash(curl *)",
      "Bash(wget *)"
    ]
  }
}

#!/bin/bash
mkdir -p .claude
cat > .claude/settings.json << 'SETTINGS'
{
  "$schema": "https://json-schema.org/claude-code-settings.json",
  "defaultMode": "autoEdit",
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git *)", "Read(*)", "Edit(*)"],
    "deny": ["Read(./.env)", "Read(./.env.*)", "Bash(rm -rf *)"]
  }
}
SETTINGS

cat > CLAUDE.md << 'CLAUDE'
# 项目说明
（在此填写项目技术栈、目录结构、开发规范）

# 构建命令
- 构建: `npm run build`
- 测试: `npm test`

# 编码规范
- TypeScript严格模式
- ESLint + Prettier
CLAUDE

echo ".claude/settings.local.json" >> .gitignore
echo "Claude Code配置已初始化！"

# 重要规则
- 修改.claude/settings.json前必须创建PR并获得审批
- 禁止在project scope中添加Bash(rm *)相关allow规则