如何清理本地 Claude Code 缓存和配置 ​

---

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

清理方法 ​

Windows 系统 ​

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

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

对他们进行改名字： ​

例如：

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

macOS 系统 ​

使用终端命令 ​

打开终端并运行：

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

bash

#!/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 - 彻底版本,移动所有配置和记录

bash

#!/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

相关文章 ​

• 如何卸载 Claude Code - 完全卸载 Claude Code
• Claude Code 安装指南 - 重新安装 Claude Code
• Windows 环境变量设置 - 配置环境变量

💡 最佳实践 ​

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

需要帮助？ ​

如果清理后遇到问题，欢迎加入我们的拼车社群获取技术支持。

---

最后更新时间: 2025-10