Claude-to-IM 桥接器
将 Claude Code / Codex 接入 Telegram、Discord、飞书、QQ 或微信，在聊天中与 AI 编程代理对话。
证据显示：权限控制通过允许用户/频道列表实现，工具调用需用户批准（内联按钮或文本命令），令牌以chmod 600存储并自动脱敏，威胁模型和事件响应在SECURITY.md中说明。扣分：依赖未固定版本，外部效果（如文件写入）未明确限制，回滚机制仅提及令牌轮换，来源归属仅基于MIT许可证和作者名，未验证发布者身份。
证据显示：README与SECURITY.md一致，故障排查部分提供常见问题解决方案，doctor命令检查环境。扣分：依赖可用性未验证（如@openai/codex-sdk为可选），失败消息未提供具体示例。
证据显示：支持多种IM平台和两种AI代理，提供安装和配置指南，明确各平台限制（如QQ仅私聊）。扣分：能力边界未明确说明（如文件操作范围），触发精度依赖自然语言，环境适配未覆盖所有平台细节。
证据显示：README结构清晰，安装说明详细，许可证为MIT，已知限制在README中列出。扣分：版本号仅0.1.0，无变更日志，维护责任未明确（无贡献指南或问题跟踪）。
证据显示：输出为IM消息，具有实际价值（远程控制编码代理），成本效益合理（免费开源）。扣分：输出可用性依赖IM平台，边际价值未量化。
证据显示：README中的声明与代码结构一致，但未提供独立验证。扣分：无测试结果或第三方验证，事实与推断未明确区分。
- 依赖未固定版本，存在供应链风险。
- 发布者身份未验证，需谨慎使用。
- 外部效果（如文件写入）未明确限制，可能影响系统安全。
- 回滚机制不完善，仅提及令牌轮换。
这个 Agent 能做什么，适合哪些场景？
Claude-to-IM 是一个技能（skill），它在后台运行一个守护进程，将 IM 平台的机器人连接至 Claude Code 或 Codex 会话。用户通过 IM 发送消息，守护进程将其转发给 AI 编程代理，并将响应（包括工具调用、权限请求和流式预览）发送回聊天。支持 Telegram、Discord、飞书/Lark、QQ 和微信，可任意组合启用。提供交互式设置向导（`/claude-to-im setup`），引导用户获取令牌、配置权限和验证设置。权限控制采用内联按钮（Telegram/Discord）或文本 `/perm` 命令及快捷回复（飞书/QQ/微信）。守护进程在后台持续运行，关闭终端后依然工作。该技能已内置到 Claude Code 和 Codex 中，安装后可通过自然语言命令管理。
运行一个 Node.js 守护进程（src/main.ts），启动桥接服务。它使用 Claude Agent SDK（src/llm-provider.ts）或 Codex SDK（src/codex-provider.ts）通过 SSE 流与 AI 代理通信。通过各 IM 平台的 Bot API 接收消息并发送回复。实现权限网关（src/permission-gateway.ts），将 SDK 的 canUseTool 回调转换为 IM 上的 Allow/Deny 按钮或文本命令，并等待用户响应（5 分钟超时）。配置和凭据存储在 ~/.claude-to-im/config.env（权限为 chmod 600）。数据存储在 data/ 目录下的 JSON 文件中，日志自动轮转并脱敏。提供管理命令（/claude-to-im start/stop/status/logs/reconfigure/doctor）和诊断脚本（scripts/doctor.sh）。
- 开发者希望在手机上通过 Telegram 或 Discord 快速查看 Claude Code 的响应并批准工具调用，而无需打开桌面终端。
- 团队在飞书/Lark 群组中共享一个 Claude Code 工作会话，成员通过群聊发送消息并审批权限。
- 个人用户使用微信扫码登录，通过微信消息与 Claude Code 交互，管理本地代码仓库。
- 使用 Codex 的用户希望在没有图形界面（CLI）的情况下，通过 QQ 私聊发送指令并接收结果。
- 需要持续后台运行桥接，在关闭终端后仍保持会话，以便在 IM 中随时继续对话。
这个 Agent 有哪些优点和局限？
- 支持五种 IM 平台（Telegram、Discord、飞书、QQ、微信），可任意组合启用
- 交互式设置向导，逐步指导获取令牌并验证，降低配置难度
- 权限控制精细，内联按钮或文本命令明确审批，避免误操作
- 流式预览（Telegram/Discord）让用户看到 AI 的实时回应
- 会话持久化，守护进程重启后仍保留上下文
- 安全性强：凭据文件权限 600，日志自动脱敏，无入站网络监听
- 必须依赖 Claude Code CLI 或 Codex CLI 作为后端，无法独立于这些代理工作
- QQ 仅支持私聊，且无内联按钮和流式预览，功能受限
- 微信使用扫码登录，仅支持单账号，且无流式预览
- 飞书/Lark 需要通过版本审核，否则机器人不会工作
- Node.js 版本要求 >=20，可能需升级环境
- 文档未提供完整的架构细节，需自行阅读源码深入理解
如何安装或部署这个 Agent？
安装依赖：Node.js >= 20。对于 Claude Code，使用 npx skills add op7418/Claude-to-IM-skill 或 git clone 到 ~/.claude/skills/claude-to-im 目录。对于 Codex，运行 git clone https://github.com/op7418/Claude-to-IM-skill.git ~/code/Claude-to-IM-skill 然后执行 bash ~/code/Claude-to-IM-skill/scripts/install-codex.sh。安装后，在 Claude Code 中运行 /claude-to-im setup，或在 Codex 中运行 claude-to-im setup。设置向导会引导选择渠道（Telegram/Discord/飞书/QQ/微信）并输入令牌。
如何使用这个 Agent？
在 Claude Code 中运行 /claude-to-im start，或在 Codex 中运行 start bridge 启动守护进程。在 IM 应用中向机器人发送消息。当 Claude 需要工具权限时，点击聊天中的 Allow/Deny 按钮（Telegram/Discord）或回复 /perm 命令及 1/2/3 快捷数字（飞书/QQ/微信）。使用 /claude-to-im status / bridge status 检查状态，使用 /claude-to-im logs / 查看日志 查看日志。运行 /claude-to-im doctor 进行诊断。更新技能：使用 npx skills add op7418/Claude-to-IM-skill 或进入安装目录执行 git pull && npm install && npm run build。
这个 Agent 与同类方案有什么区别？
README 提到该技能是从 CodePilot 桌面应用提取出的轻量级 CLI 模块。用户若需要图形界面，可考虑使用 CodePilot，它提供视觉聊天界面、会话管理、文件树预览和权限控制等功能。
常见问题
桥接器是否支持微信群聊？
如何保证令牌安全？
~/.claude-to-im/config.env，权限为 600，日志中自动脱敏，守护进程无入站网络监听。如果 5 分钟内未批准权限会怎样？
能否同时连接多个 IM 平台？
如何诊断连接问题？
/claude-to-im doctor（Claude Code）或 doctor（Codex），它检查 Node 版本、配置、令牌有效性、日志等。