Claude Code 在使用过程中会在本地生成大量缓存、日志和临时文件。定期清理这些文件可以释放磁盘空间并解决一些常见问题。

清理方法

Windows 系统

方法一：使用文件资源管理器

在 c:/用户/你的用户名/ 目录下面找到 .claude 目录和 .claude.json 文件

对他们进行改名字：

例如：

• .claude 目录改为 .claude-20251014
• .claude.json 文件改为 .claude.json-20251014

macOS 系统

使用终端命令

打开终端并运行：

• ccclear.sh – 移动本地记录（所有项目会话记录会被移动）：

#!/bin/bash


#移动本地记录（所有项目会话记录会被移动）：
mv  ~/.claude/projects   ~/.claude/projects-`date "+%Y%m%d%H%M%S"`
mv  ~/.claude/shell-snapshots  ~/.claude/projects-`date "+%Y%m%d%H%M%S"`
mv  ~/.claude/statsig  ~/.claude/statsig-`date "+%Y%m%d%H%M%S"`
mv  ~/.claude/todos   ~/.claude/todos-`date "+%Y%m%d%H%M%S"`

ls  ~/.claude

• ccmoveconfig.sh – 彻底版本,移动所有配置和记录

#!/bin/bash


#彻底版本,移动所有配置和记录：
mv  ~/.claude   ~/.claude-`date "+%Y%m%d%H%M%S"`
mv  ~/.claude.json   ~/.claude.json-`date "+%Y%m%d%H%M%S"`


ls  ~/.claude

💡 最佳实践

1. 定期清理 – 建议每月清理一次缓存和日志
2. 备份配置 – 清理前务必备份重要配置文件
3. 完全退出 – 清理前确保 Claude Code 完全退出
4. 使用脚本 – 创建自动化脚本简化清理流程
5. 问题排查 – 遇到问题时先尝试清理缓存