捕获并重放 Claude Code 轨迹以进行多会话调试(使用 Agent Lens)
记录结构化的 Claude Code 轨迹、影子 git 差异,并在需要取证式调试而非临时审查转录时重放分支。
先决条件
Python 3.12 及以上版本、uv、Agent Lens,以及通过订阅或与 Claude Agent SDK 兼容的 API 密钥获得的 Claude Code 访问权限。
安装
根据你的环境使用上游安装或设置路径:
- git clone
- uv sync
- npm install
- npm run dev
来自上游的要求和注意事项:
- 需要 Python >= 3.12 和 uv。
- 使用提供商 anthropic(默认),如果未设置 ANTHROPIC_API_KEY,SDK 会回退到 ~/.claude/credentials.json 中的 Claude Code 订阅凭据(需要 Claude Pro/Max)。使用情况由你的订阅覆盖。
- 你正在探索一个 Python 代码库。请使用 MEMORY.md 记录笔记。
基本使用或入门说明:
-
注意: AgentLens 当前通过 Claude Agent SDK 支持 Claude Code。对其他代理和框架的支持正在规划中——请参阅路线图。某些功能(特别是逐轮重放)仍处于实验阶段。
-

-
bash
-
从上游文档提取:https://raw.githubusercontent.com/dreadnode/agent-lens/HEAD/README.md
