Claude-to-IM Skill

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

中文文档

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

---

工作原理

本 Skill 运行一个后台守护进程（daemon），将你的 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）或文本 /perm 命令 / 快捷回复 1/2/3（飞书/QQ/微信）进行显式确认
• 流式预览 —— 在 Telegram 和 Discord 中可实时查看 Claude 的回复输入过程
• 会话持久化 —— 守护进程重启后会话依然保持
• 密钥保护 —— 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

如果你以拷贝模式使用 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. 输入凭据 —— 向导会详细说明获取凭据的具体位置