iWC

iWC 让 Claude Code 住进微信。你在微信里发消息，它在 Mac 上调用 Claude Code，处理完再把结果回到微信。

适合想把微信当作随身 AI 入口的开发者。手机上问问题，Mac 上跑 Claude Code；多轮对话自动续上，处理期间还会显示“正在输入中”。

效果示例

你在微信发：
帮我解释这个 Go 报错

iWC：
  收到微信消息
  启动 claude --print
  复用该用户的 session
  把 Claude 回复发回微信

常用命令：

iwc              # 查看服务状态
iwc setup        # 扫码登录微信 ilink
iwc version      # 查看版本
iwc uninstall    # 卸载服务和配置

为什么选 iWC

| 问题 | 方案 | |------|------| | 手机上想问 Claude Code | 微信直接发消息，不用打开终端 | | 多轮对话容易断上下文 | 按微信用户持久化 session，自动 resume | | AI 处理时不知道有没有响应 | 处理期间显示“正在输入中” | | 重启服务后状态丢失 | token、session、context token 持久化到本地 |

快速上手

npm i -g @xdfnet/iwc

安装过程自动下载二进制、设置 launchd 开机自启。首次无微信配置会提示扫码登录。

iwc              # 验证安装，查看状态
iwc version      # 查看版本

前置要求：

• 已安装 Claude Code CLI：npm i -g @anthropic-ai/claude
• 已开通微信 ilink 机器人能力，并拿到可扫码登录的环境
• macOS 使用 launchd 常驻后台

工作原理

你在微信发消息
        │
        ▼
┌─────────────────────────────────────────────────────┐
│  iwc — Mac 上常驻的微信 ↔ Claude Code 桥接服务        │
│                                                       │
│   微信 ilink 长轮询                                  │
│         │                                            │
│         ▼                                            │
│   weixin.Platform                                    │
│   （接收消息 / 发送回复 / 打字状态）                  │
│         │                                            │
│         ▼                                            │
│   engine                                             │
│   （按用户恢复 session，串起处理流程）                │
│         │                                            │
│         ▼                                            │
│   claude.Agent                                       │
│   （启动 claude --print，读取 stdout）                │
└─────────────────────────────────────────────────────┘

消息处理流程：

微信消息 → 长轮询接收 → session resume → claude --print → 微信回复

全部命令

iwc              # 查看状态
iwc setup        # 扫码登录微信
iwc uninstall    # 停止服务、删除配置和数据
iwc version      # 版本
iwc help         # 帮助

配置说明

~/.config/iwc/config.toml：

[wechat]
token = "你的 ilink token"
base_url = "https://ilinkai.weixin.qq.com"
allow_from = ""
long_poll_timeout_ms = 35000

[claude]
work_dir = "/Users/admin"
cli_path = "claude"

[system]
data_dir = "/Users/admin/.config/iwc"

说明：

• allow_from 为空时允许所有微信用户；生产使用建议限制来源。
• work_dir 决定 Claude Code 默认在哪个目录里工作。
• cli_path 可填写 claude 或 Claude CLI 的绝对路径。
• 旧版 ~/.iwc/config.toml 会自动迁移到 ~/.config/iwc/config.toml。

开发命令

make build      # 编译
make test       # 测试
make release    # 发布
make clean      # 清理

文件路径

| 文件 | 用途 | |------|------| | ~/Library/LaunchAgents/com.user.iwc.plist | macOS 自动启动服务 | | ~/.config/iwc/config.toml | 微信、Claude、系统配置 | | ~/.config/iwc/wechat/sessions.json | 微信用户到 Claude session 的映射 | | ~/.config/iwc/wechat/context_tokens.json | 微信用户到 context token 的映射 | | ~/.config/iwc/iwc.log | 标准日志 | | ~/.config/iwc/iwc_error.log | 错误日志 |

License

MIT — 随便用，随便改。