Claude-to-IM Skill

将 Claude Code / Codex 连接至即时通讯（IM）平台 —— 让你能够通过 Telegram、Discord、飞书/Lark、QQ 或微信与 AI 编程助手进行对话。

中文文档

想要桌面图形界面？ 请查看 CodePilot —— 这是一个功能完备的桌面应用，包含可视化聊天界面、会话管理、文件树预览、权限控制等功能。本 Skill 是从 CodePilot 的 IM 桥接模块中提取出来的，专门为需要轻量化、纯 CLI 设置的用户准备。

---

工作原理

本 Skill 运行一个后台守护进程，将你的 IM 机器人连接到 Claude Code 或 Codex 会话中。来自 IM 的消息会被转发给 AI 编程助手，响应内容（包括工具调用、权限请求、流式预览）会被发送回你的聊天窗口。

You (Telegram/Discord/Feishu/QQ/WeChat)
  ↕ Bot API
Background Daemon (Node.js)
  ↕ Claude Agent SDK or Codex SDK (configurable via CTI_RUNTIME)
Claude Code / Codex → reads/writes your codebase

功能特性

• 支持五大 IM 平台 —— Telegram、Discord、飞书/Lark、QQ、微信 —— 可任意组合使用
• 交互式设置 —— 向导式安装，提供分步说明以收集 Token
• 权限控制 —— 工具调用需要明确授权，可通过 Telegram/Discord 的行内按钮，或通过飞书/QQ/微信的 /perm 命令 / 快捷 1/2/3 回复进行确认
• 流式预览 —— 实时查看 Claude 的响应生成过程（适用于 Telegram 和 Discord）
• 会话持久化 —— 重启守护进程后对话依然保留
• 密钥保护 —— Token 以 chmod 600 权限存储，并会在所有日志中自动脱敏
• 零代码开发 —— 安装 Skill 后直接运行 /claude-to-im setup，或直接对 Codex 说 claude-to-im setup

前置要求

• Node.js >= 20
• Claude Code CLI（用于 CTI_RUNTIME=claude 或 auto） —— 已安装并认证（claude 命令可用）
• Codex CLI（用于 CTI_RUNTIME=codex 或 auto） —— npm install -g @openai/codex。认证方式：运行 codex auth login，或设置 OPENAI_API_KEY（可选，用于 API 模式）

安装指南

请根据你实际使用的 AI 代理产品选择对应的安装方案。

Claude Code

推荐方式：npx skills

npx skills add op7418/Claude-to-IM-skill

安装完成后，对 Claude Code 说：

/claude-to-im setup

如果你特别需要微信接入，也可以说：

帮我接微信

替代方式：直接克隆到 Claude Code 的 skills 目录

git clone https://github.com/op7418/Claude-to-IM-skill.git ~/.claude/skills/claude-to-im

Claude Code 会自动发现它。

替代方式：软链接（用于开发）

git clone https://github.com/op7418/Claude-to-IM-skill.git ~/code/Claude-to-IM-skill
mkdir -p ~/.claude/skills
ln -s ~/code/Claude-to-IM-skill ~/.claude/skills/claude-to-im

Codex

推荐方式：使用 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

如需在本地进行实时开发：

bash ~/code/Claude-to-IM-skill/scripts/install-codex.sh --link

安装脚本会将 Skill 放置在 ~/.codex/skills/claude-to-im 目录下，安装依赖并构建守护进程。

安装完成后，对 Codex 说：

claude-to-im setup

如果你特别需要微信接入，也可以说：

帮我接微信桥接

替代方式：直接克隆到 Codex 的 skills 目录

git clone https://github.com/op7418/Claude-to-IM-skill.git ~/.codex/skills/claude-to-im
cd ~/.codex/skills/claude-to-im
npm install
npm run build

验证安装

Claude Code： 开启新会话并输入 / —— 你应该能在 Skill 列表中看到 claude-to-im。或者问 Claude：“What skills are available?”

Codex： 开启新会话并输入 claude-to-im setup、start bridge 或 帮我接微信桥接。

更新 Skill

请根据你的 AI 代理产品和安装方法选择对应的更新流程。

Claude Code

如果你是通过 npx skills 安装的，请重新运行：

npx skills add op7418/Claude-to-IM-skill

如果你是通过 git clone 或软链接安装的：

cd ~/.claude/skills/claude-to-im
git pull
npm install
npm run build

然后对 Claude Code 说：

/claude-to-im doctor
/claude-to-im start

Codex

如果你是使用安装脚本以“复制模式”安装的：

rm -rf ~/.codex/skills/claude-to-im
bash ~/code/Claude-to-IM-skill/scripts/install-codex.sh

如果你是使用 --link 方式安装或直接克隆到 Codex skills 目录的：

cd ~/.codex/skills/claude-to-im
git pull
npm install
npm run build

然后对 Codex 说：

claude-to-im doctor
start bridge

快速开始

1. 设置

Claude Code

/claude-to-im setup

Codex

claude-to-im setup

向导将引导你完成以下步骤：

1. 选择渠道 — 选择 Telegram、Discord、飞书、QQ、微信或它们的任意组合
2. 输入凭据 — 向导会详细说明获取方式