用途:claude-to-im 用于把 Claude Code 桥接到 IM 平台(Telegram、Discord、飞书/Lark),通过后台守护进程让用户在即时通讯中与 Claude 交互。用户数据存放于 ~/.claude-to-im/。
主要能力:支持 setup(配置)、start(启动桥接)、stop(停止)、status(状态)、logs(查看日志,默认 50 行)、reconfigure(修改配置)、doctor(诊断)等子命令。支持多通道:Telegram 适合个人使用,含流式预览与内联权限按钮;Discord 适合团队,支持服务器/频道/用户级访问控制;飞书适合飞书团队,基于事件的消息。运行时可选择 claude(默认,需 claude CLI)、codex(需 codex CLI,通过 codex auth login 或 OPENAI_API_KEY 认证)或 auto(优先 Claude,找不到则回退 Codex)。模式有 code(默认)、plan、ask。
使用方式:先定位 SKILL.md 得到 SKILL_DIR。setup 为交互式向导,需 AskUserQuestion 工具;在 Codex 等无该工具的环境下改为非交互指引,展示 SKILL_DIR/config.env.example 并让用户手动创建 ~/.claude-to-im/config.env。配置前应先阅读 SKILL_DIR/references/setup-guides.md 获取各平台步骤。启动前需确认 config.env 存在,否则引导至 setup。启动命令为 bash "SKILL_DIR/scripts/daemon.sh" start,停止/状态/日志同理。配置写入后执行 chmod 600 ~/.claude-to-im/config.env,并校验令牌(Telegram 用 getMe,飞书用 tenant_access_token,Discord 校验格式)。
限制:Telegram 至少需设置 Chat ID 或 Allowed User IDs 之一;Discord 至少需设置 Allowed User IDs 或 Allowed Channel IDs 之一,否则默认拒绝所有消息。守护进程由平台监管程序管理(macOS launchd、Linux setsid、Windows WinSW/NSSM)。输出中密钥仅显示末 4 位。修改配置后需先 stop 再 start 生效。具体模型名称不硬编码,留空则继承运行时默认。