Public
Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md
cli-in-wechat
在微信中运行主流 AI 编程 CLI 工具 —— 通过微信 ClawBot 官方 iLink Bot API 实现。
支持的工具： Claude Code / Codex CLI / Gemini CLI / Kimi Code / OpenCode
它是什么
一个运行在你电脑上的桥接服务。微信是遥控器，电脑是执行端。
微信 ClawBot (手机)
↕ iLink Bot API — 微信官方消息通道 (不封号)
桥接服务 (你的电脑)
↕ spawn / Agent SDK
claude -p / codex exec / gemini -p / kimi -p / opencode run
功能
- 5 大 CLI 工具，通过
@前缀随时切换 - 最高权限默认开启
- AskUserQuestion：Claude Code 的交互式提问转发到微信（Agent SDK）
- 会话续接：连续对话自动保持上下文
/resume：浏览所有历史会话，选编号恢复（类似终端的/resume）- 跨通道漫游：
/session set <id>从终端接续同一会话 - 工具接力：
>>传递上条结果，@tool1>tool2链式调用 - 40+
/命令覆盖所有 CLI 核心 flag - 微信引用消息智能路由：回复哪条消息就由哪个工具接手
安装
前置要求
- Node.js >= 18
- 微信 已启用 ClawBot 插件（我 → 设置 → 插件）
- 至少一个 CLI 工具：
npm install -g @anthropic-ai/claude-code # Claude Code
npm install -g @openai/codex # Codex CLI
npm install -g @google/gemini-cli # Gemini CLI
npm install -g @moonshot-ai/kimi-code # Kimi Code (或 curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash)
brew install opencode-ai/tap/opencode # OpenCode运行
git clone https://github.com/sgaofen/cli-in-wechat.git
cd cli-in-wechat
npm install
npm run dev # 开发模式
npm run dev:debug # 调试模式首次运行显示 QR 码，用微信扫码登录 ClawBot。
CLI 工具认证
claude # Anthropic 订阅账号
codex # ChatGPT 账号
gemini # 设置 GEMINI_API_KEY 或 OAuth
kimi login # Kimi OAuth
# OpenCode: 设置 ANTHROPIC_API_KEY / OPENAI_API_KEY 等环境变量使用方法
发消息
| 输入 | 行为 |
|---|---|
| 直接打字 | 发给上次使用的工具 |
@claude 写排序算法 | Claude Code |
@codex fix the bug | Codex CLI |
@gemini 解释代码 | Gemini CLI |
@kimi 重构模块 | Kimi Code |
@opencode 分析项目 | OpenCode |
切换后后续消息默认发给该工具。
工具接力
@claude 分析这个项目的架构
>> @codex 根据分析修复代码 ← Claude 输出作为 Codex 上下文
>> 继续优化 ← 继续用 Codex
@claude>codex 先分析再修复 ← 链式调用
恢复历史会话
/resume ← 列出所有历史会话 + 摘要
/resume 3 ← 恢复第 3 个
/session set <uuid> ← 从终端接续会话
AskUserQuestion
Claude Code 需要你做选择时，问题自动转发到微信：
你发: @claude 帮我新建项目
微信收到:
Claude Code 需要你的回答:
❓ What language?
1. Python
2. TypeScript
3. Rust
你回复: 2
→ Claude 继续执行
完整命令列表
设置
| 命令 | 作用 | 工具 |
|---|---|---|
/status | 查看所有配置 | 通用 |
/model <名> | 切模型 | 所有 |
/mode <auto|safe|plan> | 权限模式 | 所有 |
/effort <low|med|high|xhigh|max> | 思考深度 | Claude |
/turns <数> | 最大轮次 | Claude |
/budget <$> | API 预算 | Claude |
/dir <路径> | 工作目录 | 通用 |
/system <提示> | 系统提示 | Claude |
/tools <列表> | 允许工具 | Claude |
/notool <列表> | 禁用工具 | Claude |
/verbose | 已弃用（Kimi 新版无 --verbose） | — |
/bare | 跳过配置加载 | Claude |
/adddir <路径> | 额外目录 | Claude/Codex |
/name <名> | 会话命名 | Claude |
/sandbox <ro|write|full> | 沙箱 | Codex |
/search | web 搜索 | Codex |
/ephemeral | 临时模式 | Codex |
/profile <名> | 配置 | Codex |
/thinking | 已弃用（Kimi 新版无 --thinking） | — |
/approval <模式> | 审批模式 | Gemini |
/include <目录> | 上下文目录 | Gemini |
/ext <名> | Extensions | Gemini |
/thoughts | 显示 AI 思考内容 | 通用 |
/msgmode <verbose|normal|compact|default> | 消息详细度 | 通用 |
操作
| 命令 | 作用 |
|---|---|
/diff | 查看 git 差异 |
/commit | 创建 git 提交 |
/review | 代码审查 |
/plan [描述] | 规划 / 切 plan 模式 |
/init | 创建项目配置文件 |
/files | 目录结构 |
/compact | 压缩上下文 |
/stats | 使用统计 |
/send <文件路径> | 发送本地文件到微信 |
会话
| 命令 | 作用 |
|---|---|
/new | 新会话 |
/clear | 清除所有 |
/cancel | 取消任务 |
/fork | 分支会话 |
/resume | 浏览历史会话，选编号恢复 |
/resume <编号|uuid> | 恢复指定会话 |
/session | 查看当前会话 ID |
/session set <id> | 跨通道漫游 |
快捷
| 命令 | 等效 |
|---|---|
/yolo | mode=auto + effort=max |
/fast | effort=low |
/reset | 重置所有设置 |
/cc /cx /gm /km /oc | 快速切工具 |
权限模式
| 模式 | Claude | Codex | Gemini | Kimi | OpenCode |
|---|---|---|---|---|---|
auto | --dangerously-skip-permissions | --yolo | --approval-mode yolo | -p（自带 auto） | --auto |
safe | 默认权限 | --sandbox workspace-write | --approval-mode default | -p 恒 auto | — |
plan | --permission-mode plan | --sandbox read-only | --approval-mode plan | — | — |
注：Kimi 非交互模式（
-p）永远是 auto 权限，--prompt不能与--yolo/--auto/--plan同用，故/mode对 Kimi 无效。
配置
~/.wx-ai-bridge/config.json：
{
"defaultTool": "claude",
"workDir": "/Users/you",
"cliTimeout": 300000,
"allowedUsers": [], // 见下方「安全」说明，留空 = 任何人可控制
"tools": {
"claude": { "args": ["--max-turns", "50"] }
}
}安全：
allowedUsers留空意味着任何能私聊机器人的微信好友都能以完整权限运行 CLI。 建议填入你自己的ilink_user_id（启动日志会提示）。
网络与代理（故障排查）
所有对微信接口的请求都带 超时 + 指数退避抖动重试 + 可读诊断。瞬时网络抖动
（如 read ECONNRESET、fetch failed）会被自动重试吞掉，不再像以前那样启动即崩
（issue #18）。
-
代理：Node 的全局
fetch默认不读代理环境变量。若你需要走代理访问微信， 设置HTTPS_PROXY（或HTTP_PROXY/ALL_PROXY）并安装可选依赖undici：npm i undici # 启用代理支持（可选依赖） export HTTPS_PROXY=http://127.0.0.1:7890 npm run dev -
仍然
ECONNRESET/fetch failed：确认本机可访问ilinkai.weixin.qq.com； 尝试关闭/更换代理或 VPN；用npm run dev:debug查看带诊断的日志。 -
会话过期自动重登：token 失效（errcode -14/-13）时会自动重新出示 QR 码重登， 而不是直接退出。
架构
src/
├── index.ts # 入口
├── config.ts # 配置
├── cli/ # 子命令
│ └── send.ts # wcli send：发送本地文件到微信
├── ilink/ # 微信 iLink Bot API
│ ├── types.ts # 协议类型
│ ├── auth.ts # QR 扫码登录
│ └── client.ts # 长轮询 + 发消息 + typing
├── adapters/ # CLI 工具适配器
│ ├── base.ts # 接口 + 共享 helpers (spawnCli: 绕 .cmd shim 直连 node/exe, argv 逐字)
│ ├── claude.ts # Agent SDK + CLI 降级
│ ├── codex.ts # codex exec + stdin 传参
│ ├── gemini.ts # gemini + stdin 传参 (-o json)
│ ├── kimi.ts # kimi -p (argv 传参, spawnCli 防 cmd.exe 损坏) + --continue 续会话
│ ├── opencode.ts # opencode run --format json
│ └── registry.ts # 自动检测已安装工具
├── bridge/ # 桥接逻辑
│ ├── session.ts # 会话持久化 (原子写)
│ ├── formatter.ts # 响应格式化
│ └── router.ts # @ 路由 + / 命令 + >> 接力 + 链式调用
│ # + /resume 历史会话浏览
│ # + AskUserQuestion 微信转发
└── utils/ # 工具库
├── http.ts # 带超时/重试/代理的 fetch (issue #18)
├── media.ts # 媒体下载 + AES 解密 + 文件名净化
├── crypto.ts # AES-ECB / 签名工具
└── logger.ts # 分级日志
微信 iLink Bot API
微信 2026 年 3 月推出的 ClawBot 插件官方 API：
- 域名：
ilinkai.weixin.qq.com（腾讯官方） - 认证：QR 扫码 → Bearer token
- 收消息：HTTP 长轮询 (35s)
- 发消息：POST + context_token
- 官方通道，不封号
License
MIT