用途:搜索和分析过去的 Claude Code 会话与对话日志,按日期、关键词或主题查找对话,并提取决策、代码改动等信息。所需工具仅为 jq 和 rg(ripgrep),无需其他外部命令行工具。
依赖安装:brew install jq;sudo apt install jq;brew install ripgrep;sudo apt install ripgrep;验证 jq --version && rg --version。
常见日志位置:~/.claude/ 存放设置与记忆;~/.claude/projects/ 存放各项目会话数据;workspace/ 存放已保存的会话输出;memory/ 存放智能体记忆文件。
主要用法:列出近期会话文件 ls -lt ~/.claude/projects/ | head -20;按关键词搜索 rg "keyword" ~/.claude/projects/ --type json -l;带上下文搜索 rg -C 3 "keyword" ~/.claude/projects/ --type json;搜索记忆文件 rg "topic" memory/ -l 与 rg -i "topic" memory/learned-today.md;用 jq 解析 JSONL,例如 cat <session-file.jsonl> | jq -r 'select(.role=="user") | .content',提取工具调用 select(.type=="tool_use") | {name, input};按日期查找用 find ~/.claude/projects/ -name "*.json" -newer 配合 date;搜索 workspace 输出 rg -i "keyword" workspace/ -l。
规则与限制:运行前先确认 jq 和 rg 已安装,未安装则显示安装命令并停止;不得读取或暴露日志中的原始 API 密钥、令牌或凭据,展示输出前需对敏感模式做脱敏;默认先搜索 memory/ 和 workspace/,必要时再扩大至 ~/.claude/projects/;结果较多时保存到 workspace/session-search-<query>.md 并在线摘要,在线输出限制 20-30 行。官方未提供其他功能、收费或平台信息。