Im Agent — Development skill for Claude Code

im-agent

用飞书（以后还有 Telegram 等）和 Web 页面，驱动本机的 **Claude Code** 和 **Codex**。

由 `feishu-claude-bridge` 和 `feishu-codex-bridge` 合并而来：一个进程、一份配置，飞书和网页共用同一套会话、审批和模型切换。

能做什么

• 多个 agent：Claude Code（官方 Claude Agent SDK）、Codex（官方 codex app-server）。在同一条会话里 /agent 切换，各 agent 的上下文各自保留。
• 多个飞书机器人：一个机器人对应一个 agent，或者一个机器人能切换多个 agent，都在设置页里勾选。机器人能在 Web 上扫码创建，改完配置立即生效，不用重启。
• Web 聊天页：电脑和手机都能用，界面参照 ChatGPT。
  • 回复逐字显示，markdown 和代码高亮，思考过程和工具调用可以折叠。
  • 授权卡、提问卡直接在页面上点。
  • 支持上传附件（粘贴、拖拽，手机上可以拍照）。
  • 可以「添加到主屏幕」当 App 用。手机切到后台再回来会自动重连，并补上错过的内容。
  • 系统通知：回复完成、出错、需要授权或提问时推送到手机 / 电脑（设置 → 通知 里按设备开启）。标准 Web Push，不用注册任何开发者账号；需要 HTTPS 访问，iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
  • 收到推送时，主屏 / 桌面 PWA 图标上显示未读角标（iOS 16.4+、桌面 Chrome / Edge），打开页面自动清零。
  • 切换工作目录可以在目录树里一层层点选；新对话发第一条消息前也能先选好目录。
  • 语音输入：输入框旁的麦克风按钮，用浏览器自带的语音识别（Chrome / Edge / Safari，需要 HTTPS）。
  • 新对话页：大标题里点目录名切换工作目录；输入框上方的条里选目录和 agent，右下角直接选模型和思考程度（弹出菜单，不用开弹窗）。会话中 agent 不切换（命令 /agent 仍可切），模型和思考程度随时可换。
  • 输入框里显示上下文窗口占用（小圆环，悬停看已用 / 剩余 token）。
  • 侧栏分「最近」和「项目」两组：Web 会话按工作目录归类，飞书机器人各占一行并带飞书图标；分组可折叠，宽度可拖动，双击会话重命名，名字太长时悬停滚动显示。
  • 侧栏底部显示 Claude / Codex 的订阅额度（5 小时 / 7 天窗口，悬停看重置时间）；空闲时按设置的间隔自动刷新（默认 10 分钟），跑完一轮后也会刷新。
• 跨渠道同步：飞书里的会话在 Web 上也能打开，接着聊。同一个授权请求同时出现在飞书卡片和网页上，哪边先点算哪边，另一边自动变成「已处理」。
• 设置都在网页上：工作目录、各 agent 的默认模型和思考程度、Codex 沙箱、飞书机器人、配对批准、Claude 的「总是允许」名单、登录设备管理。

安装

npm install -g im-agent         # 或者在仓库里 npm install 后用 node bin/cli.js
im-agent start                  # 前台运行，日志里会打印首次登录用的设置码
im-agent service install        # 注册为开机自启服务（systemd / launchd）

打开 `http://<机器 IP>:8800`：第一次需要输入日志里的设置码，然后设一个登录密码。

从旧桥接器迁移

im-agent import --dry-run       # 先看会导入什么
systemctl --user disable --now feishu-claude-bridge feishu-codex-bridge   # 同一个机器人不能被两个程序同时连
im-agent import                 # 导入机器人凭据、白名单、配对、会话绑定、总是允许名单
im-agent service install

导入后，飞书群里原来的会话会接着聊。

命令

命令	作用
im-agent start	启动
im-agent import [--only claude|codex] [--disabled] [--dry-run]	从旧桥接器导入
`im