只需执行以下命令即可运行该项目：

npx claude-run

浏览器将自动打开，访问地址为 http://localhost:12001。

功能特性

• 实时流式传输：观看 Claude 回复时对话内容的实时更新
• 搜索功能：按提示文本或项目名称查找会话
• 按项目筛选：专注于特定项目
• 恢复会话：复制恢复命令，在终端中继续任何对话
• 可折叠侧边栏：最大化查看区域
• 深色模式：保护视力
• 简洁界面：熟悉的聊天界面，支持工具调用的折叠显示

使用方法

通过 npm 全局安装：

npm install -g claude-run

然后在任意目录下运行：

claude-run

浏览器将自动打开，访问地址为 http://localhost:12001，展示你所有的 Claude Code 对话记录。

claude-run [选项]

选项：
  -V, --version        显示版本号
  -p, --port <number>  监听端口（默认：12001）
  -d, --dir <path>     Claude 目录（默认：~/.claude）
  --no-open            不自动打开浏览器
  -h, --help           显示帮助信息

工作原理

Claude Code 将对话历史存储在 ~/.claude/ 目录下。该工具读取这些数据，并以网页界面呈现，包含以下内容：

• 会话列表：所有对话按时间顺序排列
• 项目筛选器：专注于特定项目
• 对话视图：完整的消息历史，包括工具调用
• 会话标题栏：显示对话标题、项目名称和时间戳
• 恢复命令：复制用于恢复对话的命令
• 实时更新：使用 SSE 流技术实现对话的实时刷新

系统要求

• Node.js 20+
• 已安装并至少使用过一次 Claude Code

开发指南

# 克隆仓库
git clone https://github.com/kamranahmedse/claude-run.git
cd claude-run

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产环境
pnpm build

许可证

MIT 许可证 © Kamran Ahmed

Claude Run 快速上手指南

Claude Run 是一个轻量级工具，旨在通过美观的 Web 界面浏览和管理你的 Claude Code 对话历史。它支持实时流式更新、会话搜索、项目过滤以及一键恢复终端会话。

环境准备

在开始之前，请确保满足以下系统要求：

• Node.js: 版本 20 或更高 (node -v 检查)
• Claude Code: 必须已安装并至少运行过一次（以便生成历史记录数据）
• 操作系统: 支持 macOS、Linux 或 Windows

安装步骤

你可以通过 npm 全局安装该工具。国内开发者若遇到网络延迟，可配置淘宝镜像源加速安装。

1. （可选）配置国内镜像源

npm config set registry https://registry.npmmirror.com

2. 全局安装 claude-run

npm install -g claude-run

基本使用

安装完成后，即可在任何目录下启动服务。

1. 启动服务 直接在终端执行以下命令：

claude-run

2. 访问界面 命令执行后，浏览器将自动打开并跳转到 http://localhost:12001。如果未自动打开，请手动在浏览器访问该地址。

3. 核心功能体验

• 查看历史：左侧边栏显示所有按时间排序的对话会话。
• 实时同步：当你在终端中与 Claude 交互时，Web 界面会实时流式更新对话内容。
• 恢复会话：点击任意会话中的"Resume"按钮，复制生成的命令到终端即可继续之前的对话。
• 搜索与过滤：利用顶部搜索框通过提示词或项目名称查找特定会话。

高级选项示例 如需自定义端口或禁止自动打开浏览器，可使用以下参数：

# 指定端口为 3000 且不自动打开浏览器
claude-run -p 3000 --no-open