描述
代理工作簿是一个本地代理，位于编码代理Claude Code或Codex与底层模型之间。它为每个请求增加了一个额外的工具调用：一个让模型在回答之前思考的地方，写下它所做的决定、考虑的替代方案以及每个选项的成本。该项目的目标是让开发者检查代理的计划是否与其实际执行的操作相匹配。
阅读更多
该代理通过Docker Compose在本地运行，并在127.0.0.1:8080上公开一个仪表板，每个笔记在模型写入时实时流入，单独的CLI会话在不同的行中保持。Claude Code通过将ANTHROPIC_BASE_URL设置为本地地址来指向代理；Codex则通过自定义模型提供者进行配置。可选的连续性模式在同一轮内保持早期笔记可用（对于Codex默认开启，对于Claude Code在与已安装的Claude Code版本进行检查后，通过显式环境标志启用），并可配置会话数量、内存和空闲超时的限制。
该项目明确记录了其自身的成本。由于它在每轮中对模型进行额外调用，并在模型继续写入笔记时最多进行四次调用，因此它大致将输入令牌的使用量翻倍，并在每轮中增加数百到数千个输出令牌，并且在隐藏的笔记调用完成之前，回复不会开始流式传输，最长可达60秒。它还警告说，工作簿笔记是普通模型输出，因此粘贴的API密钥或秘密可能会出现在其中。
代理工作簿不读取或暴露模型的受保护内部推理；笔记是通过普通工具调用生成的，与模型可以写入的任何其他工具参数相同。除非操作员设置了归档路径，否则不会写入磁盘，并且项目文档明确要求用户不要使用它来收集或训练来自Anthropic或OpenAI模型的推理痕迹。它在Apache 2.0许可证下发布，并声明与这两家公司没有关联。
这是一个小型的单开发者开源项目，旨在为使用Claude Code或Codex的开发者提供在编码会话中对代理推理的可见性，而不是面向非技术用户的产品。
- 类别AI 智能体构建工具
- 定价模式开源
- 部署自托管
- 平台网页版
代理工作簿的核心功能
本地代理为每个Claude Code / Codex请求增加了一个"思考大声"的工具调用
实时仪表板（127.0.0.1:8080）在写入时流式传输每个笔记
仪表板上每个CLI会话的单独行
可选的跨请求连续性，在同一轮内保持早期笔记可用
可配置的连续性限制（会话数量、内存大小、空闲超时）
与Claude Code（通过ANTHROPIC_BASE_URL）和Codex（通过自定义提供者配置）均可兼容
完全通过Docker Compose在本地运行；除非配置，否则不会写入磁盘
Apache 2.0开源许可证
代理工作簿入门
克隆仓库：从GitHub获取项目（softcane/agents-workbook）。
启动代理：运行docker compose up -d --build。
打开仪表板：访问127.0.0.1:8080并保持该标签页打开。
将CLI指向代理：为Claude Code设置ANTHROPIC_BASE_URL，或配置Codex的模型提供者设置。
正常工作：使用Claude Code或Codex，并观察其推理流向仪表板。
启用连续性（可选）：设置WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true，以在Claude Code的工具调用之间保持笔记可用。
代理工作簿的使用案例
- 计划与行动审计
- 编码会话回顾
- 本地调试
