内容
<div align="center">
# 🔭 Claude 代码可见性
**一个本地分析仪表盘，将您的 Claude Code 使用情况转化为可行的情报。**
*了解您的成本。理解您的模式。在 30 秒内运行。*
[](https://python.org)
[](https://nodejs.org)
[](https://fastapi.tiangolo.com)
[](https://react.dev)
[](LICENSE)
---
https://github.com/user-attachments/assets/1ef40c09-e7e0-4b6b-a049-39261f9245e8
</div>
---
## 这个工具能解决什么问题？
大多数运行 Claude Code 的人都没有对其实际使用情况的可见性。这个仪表盘改变了这一点。
### 对于个人开发者
| 问题 | 在哪里找到 |
|---|---|
| 我每天/周/月花费多少钱？ | 概览 → 每日成本图表 |
| 哪个项目花费最多？ | 项目页面 |
| 我从提示缓存中获得价值吗？ | 概览 → 缓存效率 |
| Claude 在我的会话中实际使用了哪些工具？ | 工具页面 |
| 上周二 Claude 在那个会话中做了什么？ | 会话 → 全文搜索 |
| Claude 是在执行真正的自主工作还是只是回答问题？ | 概览 → 代理比率 |
| 哪些会话使用了扩展思考？ | 会话 → 展开的卡片 |
### 对于工程领导
| 问题 | 在哪里找到 |
|---|---|
| 我们这个月的 AI 工具总投资是多少？ | 概览 → 总成本 |
| 哪些代码库正在看到最多的 AI 活动？ | 项目页面 |
| 开发者是否正在执行代理工作还是简单的问答？ | 概览 → 代理比率（工具使用：结束回合） |
| 哪些 MCP 服务器和外部工具已连接？ | 配置页面 |
| 现在有多少个 Claude Code 会话正在运行？ | 配置 → 实时会话 |
| 团队使用的是哪个版本的 Claude Code？ | 概览 → 架构洞察 |
| 会话是否因 API 错误而失败？ | 会话 → ⚠ 徽章 |
---
## 功能一览
<table>
<tr>
<td width="50%">
### 💰 成本和代币分析
- 总支出，包含每个会话和项目的明细
- 每日成本和代币趋势图表
- 缓存效率 - 查看您从提示缓存中节省了多少
- 输入/输出/缓存读取/缓存写入的分割
### 🗂 会话资源管理器
- 跨 **整个对话历史** 的全文搜索
- 按项目过滤，按成本/最近程度/工具数量排序
- 每个会话：使用的模型，git 分支，权限模式（默认/计划/自动）
- 压缩计数，子代理生成，API 错误，转折时间
### 🔧 工具使用
- 每个工具按调用次数排名
- MCP 工具与内置工具的分割
- 哪些工具驱动最多的成本
</td>
<td width="50%">
### 📁 项目
- 会话计数，总成本，每个项目的主要工具
- 行变更跟踪（添加/删除）
- 最后活跃时间戳
### 🧠 架构洞察
- **代理比率** - tool_use : end_turn 告诉您您的使用情况是自主的还是对话式的
- 停止原因分布（tool_use / end_turn / 其他）
- 入口点分解（CLI，IDE 扩展，API）
- Claude Code 版本分布
- 扩展思考块，网络搜索，文件编辑
### ⚙️ 配置和基础设施
- 所有全局和每个项目的 MCP 服务器，包含传输类型
- 已安装的市场插件
- 技能使用历史
- 实时会话监视器，包含 PID，状态，正常运行时间
- 每个项目的 `allowedTools`（始终允许列表）
</td>
</tr>
</table>
### 🔥 活动热图
类似 GitHub 的提交热图，显示过去 4 个月的 Claude Code 使用强度。
---
## 快速开始
**前提条件：** Python 3.9+，Node 18+，[Claude Code](https://claude.ai/code) 已安装并至少使用过一次。
```bash
git clone https://github.com/your-username/claude-visibility.git
cd claude-visibility
./start.sh
```
就这样。脚本安装所有依赖项并打开：
| 服务 | URL |
|---|---|
| 仪表盘 | http://localhost:5173 |
| API | http://localhost:8000 |
> **Windows 用户：** 手动启动后端和前端（参见下文）。
<details>
<summary>手动启动（Windows 或高级用户）</summary>
```bash
# 终端 1 — 后端
cd server
pip install -r requirements.txt
uvicorn main:app --host 127.0.0.1 --port 8000 --reload
# 终端 2 — 前端
cd dashboard
npm install
npm run dev
```
</details>
---
## 工作原理
```
~/.claude/projects/**/*.jsonl ← Claude Code 将所有会话数据写入此处
~/.claude/backups/.claude.json ← 配置，MCP 服务器，allowedTools
~/.claude/sessions/*.json ← 实时进程状态
↓ 由
server/parsers.py （Python / FastAPI）
↓ 在 localhost:8000 处作为 JSON 提供服务
dashboard/ （React / Vite / Recharts）
↓ 在 localhost:5173 处渲染
```
没有数据会离开您的机器。所有数据都直接从您的本地 `~/.claude/` 目录读取。
---
## 可用的 Claude Code 数据
Claude Code 为每个会话写入详细的 JSONL 日志。此仪表盘显示：
- **每条消息** - 用户提示，助手响应，工具调用和结果
- **代币计数** - 输入，输出，缓存读取，缓存创建每条消息
- **使用的模型** - 每条消息（会话可以切换模型）
- **工具调用** - 名称，输入，输出，成功/失败
- **停止原因** - Claude 为什么暂停（tool_use，end_turn，max_tokens）
- **思考块** - 何时激活了扩展思考
- **会话元数据** - 斜杠，git 分支，权限模式，Claude Code 版本，入口点
- **压缩事件** - 何时自动压缩上下文窗口
- **API 错误** - 连接失败记录每个会话
---
## 平台支持
| 平台 | 状态 |
|---|---|
| macOS | ✅ 完整支持 |
| Linux | ✅ 完整支持 |
| Windows | ⚠️ 需要手动启动；实时会话检测有限 |
---
## 贡献
欢迎拉取请求。最重要的两个文件：
- `server/parsers.py` - 所有数据解析逻辑
- `dashboard/src/pages/` - 每个页面一个文件
如果您在解析器中添加了新的指标，请将类型添加到 `dashboard/src/types.ts`，它将自动流转。
---
## 许可证
MIT - 您可以随心所欲地使用它。
---
<div align="center">
<sub>为想要了解 Claude Code 黑盒的 Claude Code 高级用户而构建。</sub>
</div>
MCP 市场