IM CLI Bridge

用任意 IM 远程操控 AI 编程工具 -- 随时随地 Vibe Coding

6 大 IM 平台 | 6 大 CLI 工具 | 完全免费开源

English | 中文

---

这是什么?

这是一个 IM-CLI 桥接器，连接任意即时通讯平台和各种 AI 编程工具，让你在手机上远程操控电脑/服务器上的 CLI。

核心架构

IM 平台 (微信/Telegram/Discord/飞书/Slack/企业微信)
    |  桥接器 (本项目)
Claude Code / Codex / Cursor / Gemini / Kiro CLI (服务器/电脑)

本质:

• 这是一个桥接器 -- 连接 IM 和 CLI 工具的中间层
• CLI 跑在服务器 -- Claude、Cursor 等工具在你的服务器/电脑上运行
• IM 发指令 -- 在手机上发消息，远程操控 CLI
• 实时交互 -- 指令发送，结果返回，就像本地操作一样

不是什么:

• 不是 AI 本身 -- AI 能力来自 Claude、Codex 等官方 CLI 工具
• 不是 API 封装 -- 直接调用官方 CLI，保持原生体验
• 不是网页版 -- 运行在你自己的服务器，完全私有化

---

支持的 IM 平台

平台	消息接收方式	需要公网 IP	状态
微信 (WeChat)	本地轮询 (iLink Bot API)	否	稳定
Telegram	Long Polling	否	稳定
Discord	WebSocket Gateway	否	稳定
飞书 (Feishu/Lark)	WebSocket 长连接 / Webhook	仅 Webhook 模式	稳定
Slack	Socket Mode WebSocket	否	稳定
企业微信 (WeCom)	WebSocket 长连接 / Webhook	仅 Webhook 模式	稳定

所有平台默认使用不需要公网 IP 的连接方式。飞书和企业微信可通过环境变量切换到 Webhook 模式。

支持的 CLI 工具

CLI 工具	状态	说明
Claude Code	稳定	Anthropic 官方，推理能力强
OpenAI Codex	稳定	GPT-5.3，每个 ChatGPT 计划都包含
Cursor CLI	稳定	独立 CLI 工具，无需 IDE
Gemini CLI	稳定	Google 官方，免费额度大
Kiro CLI	稳定	AWS 官方，Claude 模型 (Win 需 WSL)
Qwen Code	稳定	通义千问，国产模型

---

快速开始

1. 准备环境

• Node.js 22+ (下载)
• 一个 AI CLI (Claude/Codex/Cursor/Gemini/Kiro 任选其一，需提前安装并登录)

2. 部署桥接器

# 克隆项目
git clone https://github.com/tmwgsicp/im-cli-bridge.git
cd im-cli-bridge

# 安装依赖
npm install

# 复制并编辑配置
cp .env.example .env

3. 配置 IM 平台

编辑 .env，设置你要使用的 IM 平台：

# 选择平台: weixin, telegram, discord, feishu, slack, wecom
PLATFORM=telegram

# 选择 CLI: claude, codex, cursor, gemini, kiro, qwen
CLI_TYPE=claude

然后填入对应平台的凭证 (详见 平台创建指南 和 .env.example):

Telegram

TELEGRAM_BOT_TOKEN=123456:ABC-DEF...    # 从 @BotFather 获取

Discord

DISCORD_BOT_TOKEN=your_bot_token        # Discord Developer Portal
# 需要启用 MESSAGE CONTENT INTENT

飞书

FEISHU_APP_ID=cli_xxxxx                 # 飞书开放平台
FEISHU_APP_SECRET=xxxxx
FEISHU_MODE=ws                          # ws (无需公网IP) | webhook

Slack

SLACK_BOT_TOKEN=xoxb-xxx                # Slack API
SLACK_APP_TOKEN=xapp-xxx                # 需启用 Socket Mode

企业微信

WECOM_CORP_ID=ww_xxxxx                  # 企业微信管理后台
WECOM_CORP_SECRET=xxxxx
WECOM_AGENT_ID=1000002
WECOM_MODE=ws                           # ws (无需公网IP) | webhook

微信

无需额外配置，启动后扫码登录。

4. 启动

node src/index.mjs

微信平台首次启动需要扫码登录，其他平台通过 Token 自动连接。

媒体能力自动安装: 启动时自动将媒体发送规则 (语音/图片/文件) 安装到所有 CLI 的 rules 目录 (~/.claude/rules/im-media.md 等)。无需手动操作，rules 在所有模式下生效（含 -p headless 模式）。如需手动安装: node scripts/install-rules.mjs

5. (可选) 扩展功能

# 图片生成 + 语音合成 (共用一个 API Key)
MINIMAX_API_KEY=sk-xxx

# CLI 工作目录
CLAUDE_WORKDIR=/path/to/your/project

---

使用示例

远程写代码

你 (手机): 帮我写个 Python 爬虫，爬取豆瓣电影 Top250

Claude Code (服务器):
已保存到 douban_spider.py

随时切换 CLI

你: /cli cursor
切换到 Cursor

你: /cli claude
切换到 Claude

定时任务

你: 每天早上8点提醒我看日报

桥接器: [Scheduled Task Created]
ID: #task_abc1
Type: Reminder
Cron: 0 8 * * *

你: 每周一上午10点分析上周代码提交

桥接器: [Scheduled Task Created]
ID: #task_def2
Type: AI
CLI: CLAUDE

异步长任务