elidickinson/pi-claude-bridge

解决的问题

该项目为 pi 编码代理与 Claude Code 之间提供了一个桥梁，允许用户将 Claude 模型（Opus、Sonnet、Haiku）作为 pi 的主要智能，同时保持 pi 的 TUI（终端用户界面）和工具调用功能。它还允许 pi 在使用其他提供者时，将特定任务委托给 Claude Code 作为一个独立工具。

工作原理

该桥梁以两种主要模式运行：

1. 提供者模式：将 Claude 模型注册为 pi 内的提供者。当用户发送请求时，桥梁通过 Agent SDK 将请求和工具调用转发给 Claude Code，确保 bash 命令和技能被正确处理。它管理 pi 的历史记录与 Claude Code 会话之间的同步。
2. AskClaude 工具：这是一个可选工具，允许 pi 当前的 LLM（无论提供者如何）将任务或问题委托给 Claude Code。可配置为只读访问或“完整”模式（读取、写入和 bash 访问）。

适用人群

使用 pi 编码代理并希望将 Claude 的最新模型以及 Claude Code CLI 工具的特定功能集成到工作流中的开发者。

主要亮点

• 无缝模型集成：自动从 pi-ai 的目录中拉取 Claude 模型列表，支持高上下文窗口（最高达 1M 令牌）适用于支持的计划。
• 灵活委派：AskClaude 工具允许获取第二意见、代码审查，或通过 Claude Code 实现自主任务处理。
• 保留 TUI：所有工具调用和工具结果均通过 pi 的 TUI 流动，保持一致的用户体验。
• 详细调试：包含对桥梁和 Claude Code CLI 子进程的全面日志记录，用于排查会话恢复失败问题。
• 可配置控制：用户可自定义计划类型、上下文窗口限制以及 Claude Code 可执行文件的路径。