Claude-to-IM-skill 是什么?

Claude-to-IM Skill 是一个本地 Node.js 桥接器,把 Telegram、Discord、飞书/Lark、QQ 或微信机器人收到的消息转给 Claude Code 或 Codex,再把文本、流式片段和权限请求发回聊天。项目包版本为 0.1.0,MIT 许可。

⭐ 2,645 Stars 🍴 295 Forks TypeScript MIT 作者: op7418
来源:github.com/op7418/Claude-to-IM-skill;https://github.com/op7418/Claude… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

保留它是因为官方仓库当前明确支持五种 IM、Claude/Codex 双运行时、远程权限审批和本地安全控制,功能边界具体;后续仍要看是否出现持续自然搜索。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md

核心功能

五种 IM 通道

同一守护进程可连接 Telegram、Discord、飞书/Lark、QQ 和微信,并可组合启用。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md
Claude 与 Codex 运行时

通过 CTI_RUNTIME 选择 Claude Agent SDK 或 Codex SDK,代理在本机项目目录中工作。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md;https://gith…
聊天内权限批准

Telegram/Discord 用按钮,飞书/QQ/微信用命令或数字回复;等待 5 分钟未答复时自动拒绝。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md
本地凭据与白名单

配置文件权限设为 0600,日志掩码 token,并按平台限制允许的用户、频道或 guild。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/SECURITY.md

技术架构

本地后台 daemon 主动连接 IM 平台 API,不开放入站监听端口。收到消息后,provider 层调用 Claude Agent SDK 或 Codex SDK;permission gateway 把工具调用挂起并等待聊天端批准,session store 保存会话。机器人 token 与允许列表写入 ~/.claude-to-im/config.env。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md;https://gith…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) @anthropic-ai/claude-agent-sdk ^0.2.62@anthropic-ai/… @openai/codex-sdk ^0.110.0(可选)@openai/codex-… claude-to-im 本地桥接包claude-to-im… 各平台 bot token 五种 IM 通道 Claude 与 Codex 运行时Claude 与 Codex 运… 聊天内权限批准 本地凭据与白名单 Claude-to-IM-skill 项目本体 核心功能 关键依赖

技术栈

语言TypeScript / Node.js 20+框架本地 daemon、IM Bot API、Claude Agent SDK 或 Codex SDK
@anthropic-ai/claude-agent-sdk ^0.2.62@openai/codex-sdk ^0.110.0(可选)claude-to-im 本地桥接包各平台 bot token
单用户本机进程;无入站监听;需要已认证的 Claude Code 或 Codex CLI
来源:github.com/op7418/Claude-to-IM-skill/blob/main/package.json;https://g…

快速上手

先准备 Node.js 20+,并让 Claude Code 或 Codex CLI 完成认证。Claude Code 可用 `npx skills add op7418/Claude-to-IM-skill`;Codex 官方路线是克隆仓库后执行 `scripts/install-codex.sh`。第一次只接一个新建的测试机器人,运行 setup 填 token、工作目录与允许用户,再用 doctor 检查权限和 token,确认白名单后才启动 bridge。
来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md

使用场景

适合从手机查看编码代理进度、批准低风险工具调用,或把一个受限测试项目接到团队 IM。不要把它直接指向含生产凭据的主目录,也不要把机器人加入公开群后依赖提示词防护;机器人账号、允许列表和操作系统用户权限才是主要边界。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md;https://gith…

优势与局限

优势

  • 覆盖五种 IM 与两类编码代理
  • 工具调用可从聊天端明确批准或拒绝
  • token 文件权限、日志脱敏和允许列表均有官方说明
  • daemon 只做出站连接,不开放本地入站端口

局限

  • 被批准的代理仍能读写配置的本地工作目录
  • bot token 或允许账号失陷会把远程消息带入代理会话
  • 不同平台的流式预览和审批界面不一致
  • 依赖第三方 IM 平台 API、SDK 与本地常驻进程
  • 没有正式 GitHub Release;本轮没有安装或连接任何机器人
来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md;https://gith…

最新版本

截至 2026-09-23,GitHub Releases 页面没有正式 Release。仓库 package.json 当前版本为 0.1.0;安装和更新都从主分支或 skills CLI 获取,因此升级前应检查 README、package-lock 与安全说明的变化。

来源:github.com/op7418/Claude-to-IM-skill/releases;https://github.com/op74…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、package.json、SECURITY.md 与 GitHub Releases  |  limitations: 未运行安装脚本、npm install、setup、doctor 或 daemon;未创建 bot、验证 token、发送消息、批准工具调用或检查会话恢复  |  observed_output: package.json 标注版本 0.1.0 与 Node.js >=20;README 列出五个平台、两种运行时和安装命令;SECURITY.md 说明 0600 配置、日志脱敏、允许列表及仅出站连接

来源:github.com/op7418/Claude-to-IM-skill/blob/main/README.md;https://gith…

同类项目对比

Anthropic 官方 Claude Code Remote Control 可从 Claude 手机端或网页控制本地会话,并由官方账户与产品权限承载;官方帮助页列明 Pro、Max、Team、Enterprise 和 CLI v2.1.51+ 的可用条件。Claude-to-IM 则自托管 bot token,覆盖五种 IM,并自行实现允许列表和权限网关。只需官方手机入口可先用 Remote Control;需要飞书、QQ、微信或自管消息路径时再评估本项目。

来源:support.claude.com/en/articles/14554000-claude-code-power-user-tips;h…

总结评价

这个项目解决了跨 IM 控制本地编码代理的问题,也明确写出了 token、白名单和权限超时机制。真正的风险在于消息最终可触发本机工具。部署前先用独立机器人、低权限系统用户和空白测试仓库跑通拒绝、超时、token 轮换与停止流程。

来源:github.com/op7418/Claude-to-IM-skill/blob/main/SECURITY.md;https://gi…

常见问题

Claude-to-IM Skill 0.1.0 需要什么运行环境?

需要 Node.js 20 及以上,以及已经认证的 Claude Code CLI 或 Codex CLI;具体使用哪个 SDK 由 CTI_RUNTIME 决定。

这个桥接器会在电脑上开放监听端口吗?

官方安全文档称不会。daemon 是单用户本地进程,只主动连接 IM 平台 API;仍需保护本机账号和配置目录。

聊天里的陌生人能调用本地编码代理吗?

项目通过每个平台配置的允许用户、频道或 guild 列表限制来源。配置错误、账号失陷或 token 泄露仍可能绕过预期边界,所以首次应只接测试机器人和测试目录。

权限请求一直不处理会怎样?

README 的权限流程写明等待上限为 5 分钟;超时后该工具调用自动拒绝,SDK 不会继续执行该操作。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件