这里提供安装、数据来源、权限和常见问题说明。CodePulse 是一款本地运行的数据统计工具，帮助您追踪 AI 编程助手的使用情况。
了解 CodePulse 如何工作，以及如何开始追踪你的 AI 使用数据。
CodePulse 支持 Claude Code、OpenAI Codex 和 Google Gemini CLI。确保你的会话数据存储在默认位置。
CodePulse 要求 macOS 14.0（Sonoma）或更高版本，使用最新 SwiftUI 框架确保最佳体验。
首次启动时，CodePulse 会请求访问 ~/.claude、~/.codex、~/.gemini 等目录的权限。
了解 CodePulse 如何收集和处理你的 AI 编程数据。
读取 ~/.claude/projects 与 ~/.claude/transcripts 目录下的会话文件，解析消息、工具调用和 Token 用量。
读取 ~/.codex/sessions 目录下的会话数据，提取对话记录和使用统计。
读取 ~/.gemini/tmp、~/.gemini/history 和 ~/.gemini/projects.json，整合 Gemini 使用数据。
以下是关于 CodePulse 最常见的问题解答。
CodePulse 仅在获取模型定价数据时访问 LiteLLM 的 GitHub 仓库。所有会话数据都在本地解析和存储，不会上传到任何服务器。
CodePulse 从 LiteLLM 获取最新的模型定价 JSON，结合你本地会话中的输入/输出 Token 数量进行估算。定价数据会缓存到本地以减少网络请求。
请确认：1) 你已使用过 Claude Code/Codex/Gemini CLI；2) 会话数据存储在默认位置；3) 已授权 CodePulse 访问相关目录。如果问题持续，请联系支持。
所有缓存数据存储在 ~/Library/Application Support/CodePulse/cache.sqlite3。你可以随时在设置中清除缓存或导出数据。
如果常见问题没有解决你的问题，请带上相关信息联系我们。