Claude-to-IM-skill 深度解析：架构、场景与部署指南（2K★）

为什么值得关注

Claude Code / Codex 默认在终端里用，但很多人希望「在手机上、在群里、随时随地」给编码代理派活并看结果。Claude-to-IM Skill 正好把这条路打通：覆盖 Telegram/Discord/飞书/QQ/微信五大平台、带引导式配置向导、在 IM 里用按钮或文字做权限审批、支持流式预览与会话持久化，且强调密钥保护（chmod 600、日志自动脱敏）。零代码安装、跨两大主流代理（Claude Code 与 Codex）的实用定位使它受到关注，累计约 2,600 星。

来源：README Features、Installation、GitHub meta（stars 2573、created_at 2026-03-05）

核心功能

五大 IM 平台桥接

支持 Telegram、Discord、飞书/Lark、QQ、微信，可任意组合启用，把这些聊天工具变成与 Claude Code/Codex 交互的前端。

来源：README Features「Five IM platforms」、How It Works

权限审批与流式预览

代理的工具调用需显式批准——Telegram/Discord 用内联按钮，飞书/QQ/微信用 /perm 命令或 1/2/3 快捷回复；Telegram 与 Discord 还能看到 Claude 边生成边显示的流式预览。

来源：README Features「Permission control」「Streaming preview」

引导式配置与零代码安装

提供交互式 setup 向导，按步骤引导收集各平台的 token；无需写代码，装好技能后对 Claude Code 说 /claude-to-im setup（或对 Codex 说 claude-to-im setup）即可，甚至能用自然语言「帮我接微信」触发。

来源：README Features「Interactive setup」「Zero code required」、Installation

会话持久化与密钥保护

对话在守护进程重启后仍保留；token 以 chmod 600 存储并在所有日志中自动脱敏，降低凭据泄露风险。可通过 CTI_RUNTIME 配置走 Claude Agent SDK 或 Codex SDK。

来源：README Features「Session persistence」「Secret protection」、How It Works

技术架构

项目是一个 TypeScript 实现的 Claude Code / Codex 技能，核心是一个常驻的 Node.js 守护进程：它一端通过各 IM 平台的 Bot API 连接 Telegram/Discord/飞书/QQ/微信，另一端通过 Claude Agent SDK 或 Codex SDK（由 CTI_RUNTIME 配置，可 claude/codex/auto）连接 Claude Code 或 Codex 会话，把 IM 消息与代理的回复（含工具调用、权限请求、流式片段）在两端转发，代理则读写你的本地代码库。仓库含 src/（守护进程与桥接逻辑）、scripts/（如 install-codex.sh 安装脚本）、references/、evals/、SKILL.md（技能定义）、config.env.example（配置样例）。安装方式按宿主代理分流：Claude Code 用 `npx skills add` 或克隆到 ~/.claude/skills，Codex 用 install-codex.sh 装到 ~/.codex/skills 并构建守护进程。它脱胎于桌面应用 CodePilot 的 IM 桥接模块。

来源：README How It Works/Installation、仓库目录（src/、scripts/install-codex.sh、SKILL.md、config.env.example、evals/、references/）

项目知识图谱

中心为项目本体，内环 = 核心功能模块，外环 = 关键技术依赖；按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript（Node.js >= 20）框架Claude Code / Codex 技能 + 后台守护进程

关键依赖

Claude Agent SDK（CTI_RUNTIME=claude/…Codex SDK / @openai/codex（CTI_RUNTIM…各 IM 平台 Bot API（Telegram/Discord/飞书/…npx skills（Claude Code 安装）

基础设施 / 部署

本地后台 Node 守护进程，无独立服务端；技能装入 ~/.claude/skills 或 ~/.codex/skills；需 Claude Code CLI 或 Codex CLI 已认证

来源：README Prerequisites/How It Works/Installation、仓库脚本

快速上手

先备好 Node.js≥20，以及已登录认证的 Claude Code CLI（CTI_RUNTIME=claude/auto）或 Codex CLI（`npm i -g @openai/codex` 后 `codex auth login`，CTI_RUNTIME=codex/auto）。Claude Code 安装：`npx skills add op7418/Claude-to-IM-skill`，然后对 Claude 说 `/claude-to-im setup`（想接微信可直接说「帮我接微信」），按向导填各平台 token。Codex 安装：克隆后 `bash scripts/install-codex.sh`（开发用 --link），再对 Codex 说 `claude-to-im setup`。也可手动克隆到 ~/.claude/skills 或 ~/.codex/skills 后 npm install && npm run build。配好后用 `/claude-to-im doctor` 自检、`/claude-to-im start` 启动桥接。

来源：README Prerequisites/Installation/Updating 段

使用场景

适合想「随时随地用手机/群聊指挥 AI 编码代理」的开发者：通勤或离开电脑时用 Telegram/飞书给 Claude Code 派任务、看它执行与产出；团队在 Discord/飞书群里协作驱动同一个代理；用权限审批按钮远程把控代理的工具调用与危险操作；让长会话跨守护进程重启保持连续。对中文用户，微信/QQ/飞书的支持尤其方便。本质是把终端里的编码代理「搬」进日常聊天工具。

来源：README How It Works/Features、Installation

优势与局限

优势

覆盖面广：一套技能桥接 Telegram/Discord/飞书/QQ/微信五大平台，且同时支持 Claude Code 与 Codex 两大代理。
上手简单：npx skills 一键安装 + 引导式 setup 向导，零代码，自然语言即可触发配置。
安全意识好：工具调用需远程审批、token 以 chmod 600 存储并在日志脱敏、会话可持久化。
脱胎于成熟桌面应用 CodePilot 的桥接模块，MIT 开源、定位清晰。

局限

需要本地常驻守护进程并已认证好 Claude/Codex CLI，依赖较多、有一定配置成本。
通过 IM 远程驱动能读写代码库的代理，安全边界很关键——一旦 IM 账号或 bot token 泄露，风险较大，需谨慎管理权限与凭据。
各平台能力不一致（如流式预览仅 Telegram/Discord，权限审批方式因平台而异）。
属较新项目（约 2,600 星），稳定性与各 IM 平台适配仍在打磨。

来源：README Features/Prerequisites、安全相关说明、项目规模

总结评价

Claude-to-IM Skill 把「在终端用编码代理」这件事延伸到了日常聊天工具：一套技能就能让 Claude Code/Codex 在 Telegram、Discord、飞书、QQ、微信里收发任务，还带远程权限审批、流式预览与密钥保护，安装也足够轻量。对想离开电脑也能指挥代理、或在群里协作驱动代理的开发者很实用，中文 IM 支持是加分项。要权衡的是它需要常驻守护进程和已配置好的 Claude/Codex 环境，且「用 IM 远程操作能改代码的代理」对账号与权限安全要求很高。把它当作「把编码代理接进你常用聊天工具」的桥接器来用，定位与实用性都很到位。

来源：综合 README、Features、安全考量与 GitHub meta 的事实判断

透明度声明
本页内容由 AI（大语言模型）基于以下公开材料自动生成：GitHub README、代码目录结构、依赖文件、Release 信息。分析时间: 2026-05-23 18:34. 质量评分: 100/100.

数据来源：README、GitHub API、依赖文件

Claude-to-IM-skill 是什么？