文档

从这里开始#

用代理安装#

本页写给被要求为用户安装并设置 aipager 的 AI 编程代理（Claude Code，或任何能用 shell 的代理）。请一步一步照做。这里的每条命令都不会询问任何问题，也从不需要交互式终端。

参考#

架构#

aipager 是一个在后台运行的单进程 asyncio 程序。它连接三个世界：你的 Telegram 聊天、你在 dtach 下运行的 Claude Code 进程，以及 Claude Code 的 hook 系统。一切都经过同一个 event loop：没有 worker pool，没有数据库，没有进程间队列。

Hook 事件#

Claude Code 会在一个任务的固定时刻运行 hook 命令：提交了一条消息、某个工具即将运行、某个工具运行完毕、任务结束，等等。aipager 在每一个时刻都挂上 hook，并把它们变成 Telegram 里的动态：工作卡片、权限请求、回答、通知和审计日志。

机器人命令和界面#

如何从 Telegram 控制 aipager。有四种输入方式：斜杠命令、键盘按钮、Mini App 控制面板，以及自由消息（文字、文件、语音消息）。

团队模式与群组#

默认情况下，aipager 是一个私人机器人：只有你和机器人在一个私聊里，没有别人。团队模式把它开放给更多人：一个由好几位开发者一起操作会话的 Telegram 群组、其他人与机器人的私聊，或者两者都有。每个聊天有自己的成员，每个成员有一个角色，决定这个成员在那里能做什么：发送消息、回答 Claude 的问题和权限请求、管理会话，或者只是查看。

把它跑起来#

安全模型#

aipager 代表你运行 Claude Code，并从 Telegram 控制。这带来两个问题：

故障排除#

常见故障和修复方法。拿不准的时候，运行：

问题报告#

当 aipager 遇到 bug 时，你只需点一下，就能给 aipager 开发者发送一份问题报告。在发送任何东西之前你都能看到完整的报告，在你同意之前没有任何东西会离开你的电脑，而且报告绝不包含你的聊天、消息、名称、路径或 token。它只由一份固定的字段列表构成：版本、次数、日期、是/否回答、来自固定列表的选项、aipager 自身代码中的位置以及它的 bug 的 ap1- 名称，再加上一条简短的备注（仅当你写了的时候）。