深入了解 Claude Code 的文件结构和数据管理方式。
目录结构
Claude Code 在以下位置存储数据：
项目级
项目目录/
.claude/
settings.json # 项目级设置
mcp.json # MCP 服务器配置
skills/ # 自定义技能
my-skill/
skill.json
instructions.md用户级
~/.claude/
settings.json # 全局用户设置
MEMORY.md # 自动记忆
projects/ # 会话历史
{project-id}/
sessions/
{session-id}.jsonl
logs/ # 日志文件重要文件
| 文件 | 说明 |
|---|---|
.claude/settings.json | 项目级权限和配置 |
.claude/mcp.json | MCP 服务器连接配置 |
~/.claude/settings.json | 全局用户偏好设置 |
~/.claude/MEMORY.md | 自动记忆（跨项目经验） |
~/.claude/projects/ | 会话历史（JSONL 格式） |
CLAUDE.md | 项目指令（在根目录） |
会话数据
每个会话以 JSONL 格式存储：
{"type": "user", "message": "你好"}
{"type": "assistant", "message": "你好！有什么我可以帮助的？"}
{"type": "tool_use", "tool": "Read", "input": {"path": "main.py"}}管理数据
清理旧会话
# 删除 30 天前的会话
find ~/.claude/projects -name "*.jsonl" -mtime +30 -delete备份
重要的设置和记忆可以纳入版本控制：
# 将 .claude/ 加入 git（注意排除敏感数据）
git add .claude/settings.json .claude/skills/隐私
- 会话数据存储在本地
- 不会上传到 Anthropic 的服务器
- 删除
~/.claude/projects/可以清除所有历史