6.3 Settings 设置与 Hooks 钩子

什么是 Settings？

Settings（设置）是 Claude Code 的配置选项，用于控制权限、超时、模型选择、状态栏显示等行为。每个 Setting 都是一个 JSON 文件，定义特定的配置项。

什么是 Hooks？

Hooks（钩子）是开发工作流的自动化触发器，可以在特定事件发生时自动执行命令。例如，在文件编辑后自动格式化、在工具调用前创建备份等。

Settings 文件结构

权限设置

json

{
  "description": "设置描述",
  "permissions": {
    "allow": [
      "Read(**/*)",
      "Glob",
      "Grep"
    ],
    "deny": [
      "Edit",
      "Write",
      "Bash"
    ]
  }
}

状态栏设置

json

{
  "description": "状态栏描述",
  "statusLine": {
    "type": "command",
    "command": "bash -c 'echo \"状态信息\"'"
  }
}

Hooks 文件结构

json

{
  "description": "钩子描述",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "your-command-here"
          }
        ]
      }
    ],
    "PostToolUse": [...],
    "Stop": [...],
    "SubagentStop": [...]
  }
}

Hook 事件类型

事件	触发时机
`PreToolUse`	工具调用前
`PostToolUse`	工具调用后
`Stop`	Claude Code 停止工作时
`SubagentStop`	子代理完成任务时

Matcher（匹配器）

Matcher 用于指定哪些工具触发钩子：

Matcher	匹配工具
`Edit`	文件编辑
`Write`	文件写入
`Read`	文件读取
`Bash`	Shell 命令

安装 Settings 和 Hooks

bash

# 安装权限设置
npx claude-code-templates@latest --setting permissions/read-only-mode --yes

# 安装状态栏
npx claude-code-templates@latest --setting statusline/git-flow-status --yes

# 安装钩子
npx claude-code-templates@latest --hook automation/discord-notifications --yes
npx claude-code-templates@latest --hook post-tool/format-javascript-files --yes

安装后的目录结构：

.claude/
├── settings.json
└── hooks.json

Settings 分类

1. 权限设置 (permissions)

设置	描述
`read-only-mode`	只读模式，禁止修改文件
`allow-git-operations`	允许 Git 操作
`allow-npm-commands`	允许 npm 命令
`deny-sensitive-files`	禁止访问敏感文件
`development-mode`	开发模式，完整权限

2. 状态栏 (statusline)

设置	描述
`time-statusline`	显示时间和模型信息
`git-flow-status`	显示 Git Flow 分支状态
`colorful-statusline`	彩色状态栏
`context-monitor`	上下文使用监控

3. 模型设置 (model)

设置	描述
`opus-default`	默认使用 Opus 模型
`sonnet-default`	默认使用 Sonnet 模型
`haiku-default`	默认使用 Haiku 模型

4. MCP 设置 (mcp)

设置	描述
`mcp-timeouts`	MCP 服务超时配置
`mcp-retry`	MCP 重试策略

Hooks 分类

1. 自动化 (automation)

钩子	描述
`discord-notifications`	Discord 通知
`slack-notifications`	Slack 通知
`telegram-notifications`	Telegram 通知
`vercel-auto-deploy`	Vercel 自动部署

2. Git 工作流 (git-workflow)

钩子	描述
`auto-git-add`	自动添加到暂存区
`smart-commit`	智能提交

3. 开发工具 (development-tools)

钩子	描述
`lint-on-save`	保存时运行 Lint
`file-backup`	文件备份
`smart-formatting`	智能格式化

4. Pre-Tool（工具前置）

钩子	描述
`backup-before-edit`	编辑前备份
`notify-before-bash`	执行命令前通知

5. Post-Tool（工具后置）

钩子	描述
`format-javascript-files`	格式化 JS/TS 文件
`format-python-files`	格式化 Python 文件
`git-add-changes`	自动 Git Add
`run-tests-after-changes`	修改后运行测试

6. 安全 (security)

钩子	描述
`file-protection`	文件保护
`security-scanner`	安全扫描

7. 性能 (performance)

钩子	描述
`performance-monitor`	性能监控
`performance-budget-guard`	性能预算守卫

经典示例

只读模式

json

{
  "description": "Restrict Claude to read-only operations for code
    review and analysis. Safe for exploring unfamiliar codebases.",
  "permissions": {
    "allow": [
      "Read(**/*)",
      "Glob",
      "Grep",
      "LS"
    ],
    "deny": [
      "Edit",
      "Write",
      "MultiEdit",
      "Bash",
      "WebFetch"
    ]
  }
}

Git Flow 状态栏

json

{
  "description": "Display comprehensive Git Flow status with
    branch type, sync status, and change indicators.",
  "statusLine": {
    "type": "command",
    "command": "bash -c 'BRANCH=$(git branch --show-current);
      ICON=\"📁\";
      if [[ $BRANCH == feature/* ]]; then ICON=\"🌿\"; fi;
      if [[ $BRANCH == release/* ]]; then ICON=\"🚀\"; fi;
      if [[ $BRANCH == hotfix/* ]]; then ICON=\"🔥\"; fi;
      echo \"$ICON $BRANCH\"'"
  }
}

时间状态栏

json

{
  "description": "Status line with timestamp showing model,
    directory, and current time.",
  "statusLine": {
    "type": "command",
    "command": "bash -c 'input=$(cat);
      MODEL=$(echo \"$input\" | jq -r \".model.display_name\");
      DIR=$(echo \"$input\" | jq -r \".workspace.current_dir\");
      TIME=$(date \"+%H:%M\");
      echo \"[$MODEL] 📁 ${DIR##*/} | 🕐 $TIME\"'"
  }
}

Discord 通知钩子

json

{
  "description": "Send Discord notifications when Claude Code
    finishes working. Requires DISCORD_WEBHOOK_URL env variable.",
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "if [[ -n \"$DISCORD_WEBHOOK_URL\" ]]; then
              MESSAGE='{\"content\":\"🤖 Claude Code finished\"}';
              curl -s -X POST \"$DISCORD_WEBHOOK_URL\"
                -H \"Content-Type: application/json\"
                -d \"$MESSAGE\";
            fi"
          }
        ]
      }
    ]
  }
}

编辑前备份钩子

json

{
  "description": "Create automatic backup of files before any
    Edit operation for safety.",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ -f \"$CLAUDE_TOOL_FILE_PATH\" ]]; then
              cp \"$CLAUDE_TOOL_FILE_PATH\"
                \"$CLAUDE_TOOL_FILE_PATH.backup.$(date +%s)\";
            fi"
          }
        ]
      }
    ]
  }
}

JavaScript 格式化钩子

json

{
  "description": "Automatically format JavaScript/TypeScript files
    after any Edit operation using prettier.",
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "if [[ \"$CLAUDE_TOOL_FILE_PATH\" =~
                \\.(js|ts|jsx|tsx)$ ]]; then
              npx prettier --write \"$CLAUDE_TOOL_FILE_PATH\";
            fi"
          }
        ]
      }
    ]
  }
}

智能提交钩子

json

{
  "description": "Intelligent git commit creation with automatic
    message generation and validation.",
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "if git rev-parse --git-dir >/dev/null 2>&1;
              then git add \"$CLAUDE_TOOL_FILE_PATH\";
              LINES=$(git diff --cached --numstat | awk '{print $1+$2}');
              if [[ $LINES -gt 0 ]]; then
                FILENAME=$(basename \"$CLAUDE_TOOL_FILE_PATH\");
                git commit -m \"Update $FILENAME\";
              fi;
            fi"
          }
        ]
      }
    ]
  }
}

创建自定义配置

自定义权限设置

bash

# 创建设置目录
mkdir -p .claude

创建 .claude/settings.json：

json

{
  "permissions": {
    "allow": [
      "Read(**/*)",
      "Edit(**/*.ts)",
      "Write(**/*.ts)",
      "Bash(npm:*)",
      "Bash(git:*)"
    ],
    "deny": [
      "Edit(**/*.env*)",
      "Write(**/*.env*)",
      "Bash(rm -rf:*)"
    ]
  }
}

自定义钩子

创建 .claude/hooks.json：

json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'File edited: $CLAUDE_TOOL_FILE_PATH'"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo 'Claude Code session ended'"
          }
        ]
      }
    ]
  }
}

完整示例：安全开发环境

bash

#!/bin/bash
# 安全开发环境配置

# 1. 安装权限设置
npx claude-code-templates@latest \
  --setting permissions/deny-sensitive-files \
  --setting permissions/allow-git-operations \
  --yes

# 2. 安装状态栏
npx claude-code-templates@latest \
  --setting statusline/git-flow-status \
  --setting statusline/time-statusline \
  --yes

# 3. 安装安全钩子
npx claude-code-templates@latest \
  --hook security/file-protection \
  --hook security/security-scanner \
  --hook pre-tool/backup-before-edit \
  --yes

# 4. 安装开发钩子
npx claude-code-templates@latest \
  --hook post-tool/format-javascript-files \
  --hook development-tools/lint-on-save \
  --yes

# 5. 安装通知钩子（可选）
npx claude-code-templates@latest \
  --hook automation/slack-notifications \
  --yes

echo "安全开发环境配置完成！"
echo ""
echo "已配置："
echo "  - 敏感文件保护"
echo "  - 编辑前自动备份"
echo "  - 代码自动格式化"
echo "  - 保存时 Lint 检查"
echo "  - 安全扫描"
echo "  - 工作完成通知"

环境变量

一些钩子需要配置环境变量：

bash

# Discord 通知
export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."

# Slack 通知
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/..."

# Telegram 通知
export TELEGRAM_BOT_TOKEN="your-bot-token"
export TELEGRAM_CHAT_ID="your-chat-id"

最佳实践

权限最小化：只授予必要的权限
备份策略：在重要操作前创建备份
自动化格式化：保持代码风格一致
实时监控：使用状态栏监控关键信息
事件通知：重要操作完成后发送通知

下一步

6.4 MCPs 集成 - 外部服务连接
6.5 Skills 技能 - 可复用工作流

6.3 Settings 设置与 Hooks 钩子 ​

什么是 Settings？ ​

什么是 Hooks？ ​

Settings 文件结构 ​

权限设置 ​

状态栏设置 ​

Hooks 文件结构 ​

Hook 事件类型 ​

Matcher（匹配器） ​

安装 Settings 和 Hooks ​

Settings 分类 ​

1. 权限设置 (permissions) ​

2. 状态栏 (statusline) ​

3. 模型设置 (model) ​

4. MCP 设置 (mcp) ​

Hooks 分类 ​

1. 自动化 (automation) ​

2. Git 工作流 (git-workflow) ​

3. 开发工具 (development-tools) ​

4. Pre-Tool（工具前置） ​

5. Post-Tool（工具后置） ​

6. 安全 (security) ​

7. 性能 (performance) ​

经典示例 ​

只读模式 ​

Git Flow 状态栏 ​

时间状态栏 ​

Discord 通知钩子 ​

编辑前备份钩子 ​

JavaScript 格式化钩子 ​

智能提交钩子 ​

创建自定义配置 ​

自定义权限设置 ​

自定义钩子 ​

完整示例：安全开发环境 ​

环境变量 ​

最佳实践 ​

下一步 ​

6.3 Settings 设置与 Hooks 钩子

什么是 Settings？

什么是 Hooks？

Settings 文件结构

权限设置

状态栏设置

Hooks 文件结构

Hook 事件类型

Matcher（匹配器）

安装 Settings 和 Hooks

Settings 分类

1. 权限设置 (permissions)

2. 状态栏 (statusline)

3. 模型设置 (model)

4. MCP 设置 (mcp)

Hooks 分类

1. 自动化 (automation)

2. Git 工作流 (git-workflow)

3. 开发工具 (development-tools)

4. Pre-Tool（工具前置）

5. Post-Tool（工具后置）

6. 安全 (security)

7. 性能 (performance)

经典示例

只读模式

Git Flow 状态栏

时间状态栏

Discord 通知钩子

编辑前备份钩子

JavaScript 格式化钩子

智能提交钩子

创建自定义配置

自定义权限设置

自定义钩子

完整示例：安全开发环境

环境变量

最佳实践

下一步