Wexin Code Cli Bridge

wexin-code-cli-bridge

把你的微信消息桥接到 AI 编程 CLI —— 支持 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Gemini CLI](https://github.com/google-gemini/gemini-cli)、[Codex CLI](https://github.com/openai/codex)，直接在微信里跟 AI 对话。

它做了什么

这个项目通过微信的 [iLink](https://ilinkai.weixin.qq.com) Bot 协议，把微信和 AI 编程 CLI 连起来。当有人给你发微信消息时，桥接程序会自动把消息转发给选定的 CLI，然后把回复发回微信。

微信用户 → iLink API → 本桥接 → CLI (Claude/Gemini/Codex) → 回复 → iLink API → 微信用户

功能特性

• 多 CLI 后端 —— 支持 Claude Code、Gemini CLI、Codex CLI，通过 --cli 切换
• 扫码登录 —— 微信扫一扫即可连接，首次启动自动触发登录
• 独立会话 —— 每个微信用户 × 每个 CLI 拥有独立对话，支持上下文延续
• 语音转文字 —— 自动识别语音消息的文字内容
• 引用消息 —— 引用回复会自动携带原文上下文
• 输入状态 —— AI 思考时在微信端显示"正在输入..."
• Markdown 转换 —— 自动将 Markdown 格式转为纯文本
• 长消息分段 —— 超长回复自动拆分为多条微信消息
• 会话重置 —— 在微信发送 /clear 即可开启全新对话
• YOLO 模式 —— --yolo 参数跳过所有权限确认
• 自动重连 —— iLink 会话过期时自动触发重新登录
• 优雅退出 —— 支持 SIGINT/SIGTERM 信号安全退出

前置条件

• Node.js >= 22
• 至少安装以下 CLI 中的一个（并完成认证）：
  • Claude Code（claude 命令）
  • Gemini CLI（gemini 命令，npm i -g @google/gemini-cli）
  • Codex CLI（codex 命令，npm i -g @openai/codex）
• 一个微信账号

安装

git clone https://github.com/ohmyskyhigh/wexin-code-cli-bridge.git
cd wexin-code-cli-bridge
npm install

全局安装（可选）：

npm run build && npm install -g .

使用方法

直接启动即可，首次运行会自动弹出微信扫码登录：

# 使用 Claude Code（默认）
wcc start --yolo

# 使用 Gemini CLI
wcc start --cli gemini --yolo

# 使用 Codex CLI
wcc start --cli codex --yolo

# 指定模型
wcc start --cli gemini -m gemini-2.5-flash --yolo

也可以用 npm scripts（无需全局安装）：

npm run start:yolo                              # Claude（默认）
npx tsx src/cli.ts start --cli gemini --yolo    # Gemini
npx tsx src/cli.ts start --cli codex --yolo     # Codex

**为什么推荐 YOLO 模式？** AI CLI 在执行操作时会频繁请求权限确认（读取文件、运行命令等）。由于桥接程序以非交互模式运行，无法在微信端进行权限确认。`--yolo` 跳过所有权限提示，对应各 CLI 的：C