如何自定义Claude Code系统提示：gh_mirrors/cl/claude-code-system-prompts高级配置教程

【免费下载链接】claude-code-system-prompts All parts of Claude Code's system prompt, 20 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version. 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts

Claude Code是一款强大的AI编程助手，通过自定义系统提示可以显著提升其工作效率和适应性。本教程将详细介绍如何通过gh_mirrors/cl/claude-code-system-prompts项目来自定义Claude Code的系统提示，帮助开发者打造专属的AI编程体验。

准备工作：获取项目源码

首先需要将项目代码克隆到本地环境：

git clone https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts

克隆完成后，进入项目目录，可以看到主要包含以下结构：

• system-prompts/：存放各类系统提示和工具描述
• tools/：包含配置更新工具
• 项目文档文件（README.md、CHANGELOG.md等）

核心配置文件解析

系统提示文件结构

system-prompts目录是自定义Claude行为的核心，包含多种类型的配置文件：

• 工具描述文件：如tool-description-exitplanmode.md，定义工具的工作方式和使用场景
• 系统提示文件：如system-prompt-claude-in-chrome-browser-automation.md，配置特定场景下的自动化行为
• 技能配置文件：如skill-update-claude-code-config.md，提供配置更新的详细指导

配置修改决策指南

在修改配置前，需要明确是使用Config工具还是直接编辑JSON文件：

使用Config工具适合简单设置：

• theme、editorMode、verbose、model
• language、alwaysThinkingEnabled
• permissions.defaultMode

直接编辑settings.json适合复杂配置：

• 各类钩子（PreToolUse、PostToolUse等）
• 复杂权限规则（allow/deny数组）
• 环境变量配置
• MCP服务器和插件配置

自定义系统提示的完整流程

1. 明确配置意图

首先需要确定您想要实现的具体功能，例如：

• "代码写入后自动格式化" → 需要配置PostToolUse钩子
• "执行bash命令时自动记录日志" → 需要配置PreToolUse钩子
• "允许npm命令无需确认直接执行" → 需要修改权限配置

2. 读取现有配置

重要：修改前务必先读取现有配置文件，避免覆盖已有设置。配置文件通常位于：

• 全局配置：~/.claude/settings.json
• 项目配置：.claude/settings.json

3. 合并配置而非替换

修改配置时，关键是合并新配置与现有配置，特别是数组类型的设置：

错误示例（会替换现有权限）：

{ "permissions": { "allow": ["Bash(npm:*)"] } }

正确示例（保留现有配置并添加新项）：

{
  "permissions": {
    "allow": [
      "Bash(git:*)",      // 保留现有配置
      "Edit(.claude)",    // 保留现有配置
      "Bash(npm:*)"       // 添加新配置
    ]
  }
}

实用配置示例

添加自动化格式化钩子

要实现代码写入后自动格式化，可添加如下PostToolUse钩子：

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "jq -r '.tool_response.filePath // .tool_input.file_path' | xargs prettier --write 2>/dev/null || true"
      }]
    }]
  }
}

配置环境变量

要设置环境变量（如DEBUG模式）：

{ "env": { "DEBUG": "true" } }

扩展命令权限

要允许特定命令无需确认直接执行：

{
  "permissions": {
    "allow": [
      "Bash(npm:install)",
      "Bash(npm:run build)"
    ]
  }
}

常见问题与解决方案

钩子不执行怎么办？

1. 检查配置文件路径：确认修改了正确的settings.json（全局或项目）
2. 验证JSON语法：错误的JSON格式会导致配置失效
3. 检查匹配器：确保钩子的matcher与工具名称匹配（如"Bash"、"Write"）
4. 测试命令：手动运行钩子中的命令，验证其正确性
5. 开启调试模式：使用claude --debug查看钩子执行日志

如何避免配置丢失？

• 修改前备份原配置文件
• 使用版本控制系统跟踪配置变更
• 优先修改项目级配置而非全局配置

总结

通过gh_mirrors/cl/claude-code-system-prompts项目自定义Claude Code系统提示，可以让AI编程助手更好地适应个人或团队的工作流程。关键是遵循"先读取、后合并、不替换"的原则，正确使用钩子和权限系统。

无论是添加自动化工作流、定制权限控制还是配置环境变量，本教程提供的方法都能帮助您打造更高效、更个性化的Claude Code体验。开始尝试自定义您的系统提示，释放AI编程助手的全部潜力吧！

【免费下载链接】claude-code-system-prompts All parts of Claude Code's system prompt, 20 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version. 项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts