本文回答来自  gemini 和 千问

---

默认情况下，仅仅在终端中运行 claude 命令并不会在当前目录下自动生成 .claude 文件夹。Claude Code 的默认会话记录、全局配置、日志和缓存等都会统一存放在用户的主目录中（即 ~/.claude/）。

当前目录下出现 .claude/ 文件夹，通常是因为你触发了**“项目级（Project-Level）定制”**。具体在以下几种情况下，Claude Code（或你手动/通过插件）会在当前目录生成该文件夹：

1. 创建项目级的 Subagent（子代理）或 Skill（技能）

当你在对话中使用内置命令（如 /agents）让 Claude 帮你创建一个专门处理某些任务的代理（例如专门做代码审查的代理 code-reviewer），并且你选择了**项目级作用域（Project level）**时。
Claude Code 会自动在当前目录创建 .claude/agents/ 或 .claude/skills/ 文件夹，并将生成的 Markdown 配置文件（如 code-reviewer.md）存放在其中。

2. 修改并保存项目专属配置

当你在 Claude Code 中使用 /config 命令修改设置（例如切换大模型版本、调整输出语言、设置特定的安全权限），并选择将其仅应用于当前项目时，Claude Code 会在当前目录生成 .claude/settings.json（或 .claude/settings.local.json），以覆盖全局设置。

3. 配置项目级的自定义斜杠命令 (Custom Commands)

Claude Code 允许你自定义类似 /test 或 /commit-message 的斜杠命令。如果这些命令的逻辑和 Prompt 是当前项目特有的，你需要（或 Claude 会辅助你）在当前目录下生成 .claude/commands/ 目录，并将命令定义为 Markdown 文件存在里面。

4. 拆分项目记忆和规则 (Modular Rules)

为了让 Claude Code 了解你的项目规范，通常会在项目根目录放一个 CLAUDE.md。但当项目变得复杂、规则太多时，官方最佳实践建议将模块化的规则文件放入 .claude/rules/ 目录中。如果你要求 Claude 帮你整理和沉淀当前的开发规范，它可能会建议或自动在这个路径下生成规则文件。

5. 设置项目专属的 Hooks（钩子）或 MCP 服务器

• Hooks：如果你希望在 Claude Code 使用工具前或使用后自动触发一些脚本（比如运行代码格式化、安全检查），相关的 hook 脚本会被放置在 .claude/hooks/ 目录中。

• MCP (Model Context Protocol)：虽然项目级的 MCP 服务器配置有时会直接生成在根目录的 .mcp.json 中，但某些扩展或高级配置也会被存放在局部的 .claude/ 目录内。

---

总结：
当前目录下的 .claude 文件夹类似于 .vscode/ 或 .git/ 文件夹。它是一个纯粹为了管理当前项目 AI 协作上下文而存在的配置目录。如果你在当前目录看到了它，说明这个项目已经被赋予了专属的 AI 配置、自定义指令、或者自动化工具。如果你不需要这些项目级特性，完全可以将其删除，Claude Code 依然可以依赖全局配置（~/.claude/）正常工作。

Google Search Suggestions

---

根据搜索结果和 Claude Code 的工作机制，.claude 目录（或相关文件）通常在以下几种情况下会在当前项目目录中生成：

1. 首次启动并“信任”当前目录时（最常见）

当你第一次在某个项目文件夹中运行 claude 命令时，Claude Code 会进行安全检查。

• 触发过程：
  1. 你在终端进入项目目录（例如 cd my-project）。
  2. 输入 claude 启动交互式会话。
  3. Claude 会提示：“Do you trust this directory?”（你信任这个目录吗？）或类似的安全确认信息。
  4. 当你输入 y 或按回车确认信任后，Claude Code 可能会在当前目录下创建一个 .claude 文件夹（或者生成 .claude.json / CLAUDE.md 等配置文件），用于存储该项目特定的配置、记忆上下文或权限设置。
• 目的：这是为了隔离不同项目的配置，确保 AI 记住的是当前项目的特定规则（如技术栈、代码规范），而不是全局通用的。

2. 执行初始化命令 /init 时

Claude Code 内置了一些斜杠命令（Slash Commands），其中 /init 专门用于初始化项目。

• 触发过程：
  • 在 Claude Code 会话中输入 /init。
• 结果：
  • Claude 会自动分析项目结构。
  • 生成一个 CLAUDE.md 文件（通常位于根目录或 .claude 文件夹内），其中包含项目的技术栈说明、目录结构解释和开发规范。
  • 有些版本的实现中，这会直接促成 .claude 目录的创建，用来存放这些自动生成的文档和技能配置。

3. 安装“项目级技能 (Project Skills)”时

如果你使用 claude skill add 命令安装技能，并且指定了当前项目路径，或者选择将技能仅应用于当前项目：

• 触发过程：
  • 运行 claude skill add <skill-name> 并在提示时选择“Install for this project only”（仅为此项目安装）。
• 结果：
  • 系统会自动创建 .claude/skills/ 目录，并将技能的配置文件（SKILL.md）和相关脚本放入其中。
  • 这样做的目的是让该技能只对当前项目生效，不影响其他项目或全局环境。

4. 自动记忆功能 (Auto-Memory) 触发时

最新的 Claude Code 版本引入了自动记忆功能。

• 触发过程：
  • 在与 Claude 的长期对话中，当它发现某些上下文信息（如项目偏好、常用命令、架构决策）需要持久化保存时。
• 结果：
  • 它可能会在 .claude 目录下创建或更新 MEMORY.md 或其他记忆文件，以便在下次会话中自动加载这些背景知识，无需你重复说明。

---

总结：.claude 目录里通常有什么？

一旦生成，这个目录通常包含以下结构：

my-project/
├── .claude/
│   ├── skills/          # 项目专属的技能包
│   │   └── <skill-name>/
│   │       └── SKILL.md
│   ├── memory.md        # 自动记忆的项目上下文
│   └── config.json      # 项目特定的配置（如允许的工具有哪些）
├── CLAUDE.md            # 项目说明书（有时也在根目录）
└── src/                 # 你的代码

如何手动控制？

• 不想让它自动生成？
  你可以在项目根目录手动创建一个空的 .claude 文件夹，或者在配置中禁用某些自动记忆功能（具体取决于 CLI 版本）。
• 想全局使用而不是每个项目都生成？
  将技能和配置安装到用户主目录的全局路径下（通常是 ~/.claude/），这样单个项目目录就不会生成多余的配置文件了。

简而言之，当你第一次对某个项目说“我信任你”并开始深度协作时，就是 .claude 目录诞生的时刻。