Clawrelay Weixin Server — Communication skill for Claude Code

clawrelay-weixin-server

[English](./README.en.md) | 中文

[](https://www.npmjs.com/package/clawrelay-weixin-server) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/)

**在微信里直接用 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

首次运行会引导你完成：

1. 配置 — relay API 地址（默认: http://localhost:50009）、工作目录（默认: 当前目录）
2. 登录 — 用微信扫描终端中的二维码
3. 开聊 — 在微信里给 Claude 发消息

前置条件

• Node.js >= 18
• clawrelay-api 在本地或服务器上运行
• 一个微信个人账号
• Claude Pro/Max 订阅（用于 Claude Code 访问）

配置

配置文件位于 `~/.clawrelay-weixin/config.yaml`（使用 `--profile` 时位于 `~/.clawrelay-weixin//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     # 第二个微信
nod