Sniffly - Claude Code 分析仪表板

分析 Claude Code 日志，帮助您更好地使用 Claude Code。

网站 | 快速入门 | 功能 | 可共享的仪表板

📊 功能

了解您的使用模式

错误分类

查看 Claude Code 在哪些地方容易出错，从而避免这些错误。

消息历史分析

回顾您所有的指令，必要时可以与同事分享。

🚀 快速入门

• 要求：Python 3.10+

使用 UV（推荐）

请确保已安装 uv！https://github.com/astral-sh/uv

# 一次性执行（无需安装）
uvx sniffly@latest init

# 安装软件包
uv tool install sniffly@latest
sniffly init

运行 sniffly init 后，在浏览器中访问 http://localhost:8081（或您选择的主机/端口）即可打开仪表板。

如果您在远程服务器上运行 Sniffly，请使用端口转发，以便在本地计算机上打开浏览器。

使用 pip

pip install sniffly
sniffly init

从源代码安装

git clone https://github.com/chiphuyen/sniffly.git
cd sniffly
pip install -e .
sniffly init

🔧 配置

常见设置

# 更改端口（默认：8081）
sniffly config set port 8090

# 禁用自动打开浏览器
sniffly config set auto_browser false

# 显示当前配置
sniffly config show

所有配置选项

键	默认值	描述
port	8081	服务器端口
host	127.0.0.1	服务器主机
auto_browser	true	启动时自动打开浏览器
cache_max_projects	5	内存缓存中的最大项目数
cache_max_mb_per_project	500	每个项目的最大 MB 数
messages_initial_load	500	初始加载的消息数量
max_date_range_days	30	日期范围选择的最大天数

有关所有选项和命令，请参阅完整的CLI 参考文档。

💡 分享您的仪表板

您可以创建一个链接，与同事分享您项目的统计数据和指令。

1. 在仪表板中点击“📤 分享”按钮
2. 选择隐私选项：
   • 私密：只有拥有链接的人才能查看
   • 公开：会列在公共图库中
   • 包含指令：分享您的实际指令文本
3. 复制并分享生成的链接

🚨 故障排除

常见问题

sniffly help

端口已被占用？

# 使用其他端口
sniffly init --port 8090

# 或更改默认端口
sniffly config set port 8090

浏览器未打开？

# 检查设置
sniffly config show

# 启用自动打开浏览器
sniffly config set auto_browser true

# 或手动访问 http://localhost:8081

配置问题？

# 查看所有设置及其来源
sniffly config show

# 将某个设置重置为默认值
sniffly config unset port

# 删除所有自定义配置
rm ~/.sniffly/config.json

如需更多帮助，请参阅GitHub 问题页面。

🔐 隐私

Sniffly 完全在您的本地机器上运行：

• ✅ 所有数据处理都在本地进行
• ✅ 无遥测数据
• ✅ 您的对话绝不会离开您的电脑
• ✅ 共享的仪表板仅限于自愿参与

📄 许可证

MIT 许可证 - 请参阅LICENSE 文件。

🔗 链接

• 首页: sniffly.dev
• 文档: 完整 CLI 参考
• 问题: GitHub 问题

Sniffly 快速上手指南

Sniffly 是一个专为 Claude Code 设计的本地分析仪表盘，帮助你可视化使用模式、错误分布及指令历史，从而更高效地使用 Claude Code。所有数据均在本地处理，隐私安全。

环境准备

• 操作系统：支持 Windows、macOS、Linux
• Python 版本：Python 3.10 或更高版本
• 推荐工具：uv（更快的 Python 包管理工具，可选但推荐）
  • 安装 uv：访问 https://github.com/astral-sh/uv 获取安装说明
• 网络要求：首次运行需联网下载依赖，后续完全离线运行

💡 国内用户提示：若 pip 或 uv 下载缓慢，可配置国内镜像源加速（如清华源、阿里云源）。

安装步骤

方式一：使用 uv（推荐）

# 一键运行（无需永久安装）
uvx sniffly@latest init

# 或永久安装到本地工具链
uv tool install sniffly@latest
sniffly init

方式二：使用 pip

pip install sniffly
sniffly init

🇨🇳 国内加速建议：

pip install sniffly -i https://pypi.tuna.tsinghua.edu.cn/simple

方式三：从源码安装

git clone https://github.com/chiphuyen/sniffly.git
cd sniffly
pip install -e .
sniffly init

基本使用

1. 启动服务
   执行以下命令后，Sniffly 会自动扫描本地的 Claude Code 日志并启动本地服务器：

   sniffly init
   

2. 访问仪表盘
   打开浏览器访问：

   http://localhost:8081
   

   若启动时未自动打开浏览器，请手动访问上述地址。
   若在远程服务器运行，请通过 SSH 端口转发将 8081 映射到本地。

3. 查看核心功能

   • 使用统计：了解调用频率、令牌消耗等趋势
   • 错误分析：定位常见失败类型，优化提示词
   • 指令回溯：浏览历史对话与命令，支持团队分享

4. 自定义配置（可选）

   # 修改监听端口
   sniffly config set port 8090
   
   # 禁用自动打开浏览器
   sniffly config set auto_browser false
   
   # 查看当前配置
   sniffly config show
   

完成以上步骤后，即可开始分析你的 Claude Code 使用数据。所有数据仅存储于本地，安全可靠。