English | 中文
在微信里直接用 Claude Code 的全部能力 — 用你的订阅，零额外成本。
Claude Pro/Max 订阅自带 Claude Code 的使用权限。这个项目把它桥接到微信，让你在手机上就能和 Claude 对话，发图片、文件都能理解，不需要 API Key，不产生额外费用。
微信用户 ──> clawrelay-weixin-server ──> clawrelay-api ──> Claude Code（你的订阅）
文字/图片/文件 SSE 流式 完整 CLI 能力
- 零额外成本 — 使用你的 Claude Code 订阅，不消耗 API 额度
- 随时随地 — 手机微信就能和 Claude 对话
- 完整能力 — 文件编辑、Bash 命令、Web 搜索，Claude Code 的全部工具
- 多模态 — 支持发送图片和文件，Claude 能看懂并处理
- 多账号 — 同一台机器可连接多个微信号
- 一行启动 —
npx clawrelay-weixin-server
# 1. 安装并启动 clawrelay-api（将 Claude Code CLI 封装为 API）
# 参见: https://github.com/roodkcab/clawrelay-api
# 2. 启动微信桥接服务
npx clawrelay-weixin-server首次运行会引导你完成：
- 配置 — relay API 地址（默认:
http://localhost:50009）、工作目录（默认: 当前目录） - 登录 — 用微信扫描终端中的二维码
- 开聊 — 在微信里给 Claude 发消息
- Node.js >= 18
- clawrelay-api 在本地或服务器上运行
- 一个微信个人账号
- Claude Pro/Max 订阅（用于 Claude Code 访问）
配置文件位于 ~/.clawrelay-weixin/config.yaml（使用 --profile 时位于 ~/.clawrelay-weixin/<profile>/config.yaml）：
relay_url: "http://localhost:50009" # clawrelay-api 地址
working_dir: "/path/to/project" # Claude 工作目录
model: "" # 模型名（可选）
system_prompt: "" # 自定义系统提示词（可选）
allowed_users: [] # 用户白名单，空 = 不限制
env_vars: {} # 传给 Claude 的环境变量通过 --profile 参数在同一台机器上运行多个实例，连接不同微信号：
node dist/cli.js # 默认 profile
node dist/cli.js --profile work # 第二个微信
node dist/cli.js --profile bot3 # 第三个微信每个 profile 拥有独立的配置和登录状态（~/.clawrelay-weixin/<profile>/），互不干扰。
| 类型 | 发送到 Claude | 说明 |
|---|---|---|
| 文字 | ✅ | 直接转发 |
| 图片 | ✅ | CDN 下载 + AES 解密，以 base64 发送 |
| 文件 | ✅ | 支持 PDF、Office、代码等，上限 20MB |
| 语音 | ✅ | 自动使用微信语音转文字 |
| 视频 | ❌ | 提示暂不支持 |
在微信中发送以下消息控制机器人：
| 命令 | 功能 |
|---|---|
reset / new / 新对话 |
开启新的对话 |
help / 帮助 |
显示帮助信息 |
- 终端二维码扫码登录
- Token 过期自动重新登录（约 24 小时）
- 会话管理（2 小时 TTL）
- 消息去重
- Claude 思考时显示"正在输入"
- 单用户并发保护
- 优雅退出（Ctrl+C）
- 输入安全清洗（防 prompt 注入）
src/
├── cli.ts # 入口，--profile 解析，优雅退出
├── config.ts # YAML 配置读写
├── auth.ts # 二维码登录 + token 持久化
├── session.ts # 内存会话管理（2h TTL）
├── relay.ts # clawrelay-api SSE 流式适配器（支持多模态）
├── weixin.ts # iLink HTTP 长轮询 + CDN 媒体下载解密
└── orchestrator.ts # 消息路由、命令处理、安全防护
git clone https://github.com/wxkingstar/clawrelay-weixin-server.git
cd clawrelay-weixin-server
npm install
npm run build
npm test
node dist/cli.js- clawrelay-api — Go 编写的中继服务，封装 Claude Code CLI 为 API
- clawrelay-wecom-server — 企业微信连接器
- clawrelay-feishu-server — 飞书连接器
如果这个项目对你有帮助，欢迎点个 Star 支持一下！
MIT