.claude 文件夹介绍

前面几节，你建了子代理、写了 Skill、配了 Hooks、装了插件。它们最后都落在同一个地方：你电脑上的 ~/.claude 文件夹。

安装 Claude Code 之后，它会在你电脑上建这个文件夹，之后你所有的全局配置、Skill、历史记录、插件都在这里。这一节带你把 ~/.claude 里每个重要的文件和文件夹都认识一遍。

一、打开看看

终端里输入：

ls ~/.claude

你大概会看到这样一堆东西：

agents/          # 你定义的子代理（第三章 第1节 学过）
skills/          # 你的用户级 Skill（第二章 第5节 学过）
CLAUDE.md        # 你的全局 CLAUDE.md（第二章 第4节 学过）
settings.json    # 全局配置文件（本节重点）
plugins/         # 已安装的插件（第三章 第5节 学过）
projects/        # 每个项目的会话记录和自动记忆
history.jsonl    # 你输入过的每条消息
file-history/    # /rewind 用到的文件快照
sessions/        # 正在运行的会话
cache/           # 缓存

不同版本和使用习惯，文件夹内容会有些出入，但核心的几个都在。

二、settings.json：核心配置文件

这是本节的重点。

~/.claude/settings.json 是全局配置文件，前几节学过的大量配置最终都落在这里。打开看一下，你会发现它就是一个普通的 JSON 文件：

{
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": ["Read", "Grep", "Glob"],
    "deny": ["Bash(rm -rf *)"],
    "ask": ["Bash(git push *)", "Bash(git commit *)"]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "..."
          }
        ]
      }
    ]
  },
  "env": {
    "MY_NAME": "zkp"
  }
}

字段对应你前面学过的东西：