Wechat Claude Code Installer

WeChat ↔ Claude Code 一键安装 + 6 坑全过

把上游 Wechat-ggGitHub/wechat-claude-code 的安装流程包装成一个可重复执行的 skill，自动修掉首次使用一定遇到的几个体验问题。

6 个坑速览

触发方式

用户说以下任意一种：

• 「装一下微信桥」「微信里用 Claude Code」
• 「wechat-claude-code 安装」「按那篇逛逛GitHub 的文章配一下」
• /wechat-claude-code-installer

前置条件

• macOS（launchd 守护；其他 OS 上游也支持 systemd/nohup，但本 skill 修复脚本只测试过 macOS）
• Node.js ≥ 18
• 微信号一个（强烈建议用个人小号，不要用工作号）
• 已经在用 Claude Code

标准流程（4 步）

第 0 步：装前体检（必须先跑）

~/.claude/skills/wechat-claude-code-installer/scripts/doctor.sh

报告 6 项：Node 版本、是否已装、是否已绑、ANTHROPIC_BASE_URL 合规风险、OS 平台、上游漂移检测（v0.3 新增）。

重点关注 4️⃣：如果 ANTHROPIC_BASE_URL 指向本地代理（公司 LLM 网关），所有微信对话会经此代理进入公司日志——聊私事前请改 plist 切回个人 Anthropic 账号。

新增第 6 项 — 上游漂移：上游 wechat-claude-code 项目快速迭代（一周可能有 5-10 个 commit）。doctor 自动比对本地 vs 远程，发现漂移会建议你跑 check-upstream.sh --since 看具体新增哪些 commit。

第 1-2 步：一键安装（含扫码）

~/.claude/skills/wechat-claude-code-installer/scripts/install.sh "$HOME/Claude Code"

参数是 Claude Code 默认工作目录（路径含空格记得加引号）。脚本会：

1. 跑一遍 doctor（检查环境）
2. clone 上游项目到 ~/.claude/skills/wechat-claude-code/
3. npm install
4. 弹出二维码，扫码 + 微信里点确认绑定
5. 自动灌入工作目录（绕过交互式卡死）

第 3 步：一键修复全部 6 坑

~/.claude/skills/wechat-claude-code-installer/scripts/fix-all.sh "$HOME/Claude Code"

或者按需单跑：

第 4 步：起 daemon + 验证

cd ~/.claude/skills/wechat-claude-code && npm run daemon -- start

在微信里给 AI bot 发 当前工作目录是哪里，应回 ~/Claude Code 且不带元话术。

日常使用（在微信里发）

发图、发 PDF、发语音都可以；Claude 生成的文件直接推回微信。

关掉 / 重启 daemon

# 临时关
cd ~/.claude/skills/wechat-claude-code && npm run daemon -- stop

# 永久关（重启后也不起；修第 5 个坑）
launchctl unload -w ~/Library/LaunchAgents/com.wechat-claude-code.bridge.plist

# 重新启用
launchctl load -w ~/Library/LaunchAgents/com.wechat-claude-code.bridge.plist

上游漂移检测（v0.3 新增）

上游 Wechat-ggGitHub/wechat-claude-code 迭代速度极快（实测每周 5-10 个 commit），你装的版本一周后就可能落后了几个 fix。本 skill 6 个坑修法是基于上游 v1.0.0 + 特定 commit 范围，上游修了某些坑后这些修法可能多余甚至冲突。

# 看本地 vs 远程是否漂移
~/.claude/skills/wechat-claude-code-installer/scripts/check-upstream.sh

# 把当前装的版本 pin 为基线
~/.claude/skills/wechat-claude-code-installer/scripts/check-upstream.sh --pin

# 看 pin 以来上游所有 commit 列表
~/.claude/skills/wechat-claude-code-installer/scripts/check-upstream.sh --since

建议节奏：

• 每次跑 install.sh 后——自动 pin 当时上游 commit
• 每周跑一次 check-upstream.sh --since——看上游加了哪些 commit
• 看到关键 fix（如"修了 cwd 问题"）→ 升级试装 → 验证 6 坑还要不要修 → 更新 pin

切换 API 端点（避开公司代理）

如果 doctor 报告 ANTHROPIC_BASE_URL 指向公司代理，且不希望微信对话经过公司日志：

PLIST=~/Library/LaunchAgents/com.wechat-claude-code.bridge.plist
python3 <<'PY'
import plistlib, os
p = os.path.expanduser("~/Library/LaunchAgents/com.wechat-claude-code.bridge.plist")
with open(p, 'rb') as f: d = plistlib.load(f)
env = d.setdefault('EnvironmentVariables', {})
env['ANTHROPIC_AUTH_TOKEN'] = 'sk-ant-api03-你的key'
env['ANTHROPIC_BASE_URL'] = 'https://api.anthropic.com/v1/'
with open(p, 'wb') as f: plistlib.dump(d, f)
print("done")
PY
launchctl unload ~/Library/LaunchAgents/com.wechat-claude-code.bridge.plist
launchctl load ~/Library/LaunchAgents/com.wechat-claude-code.bridge.plist

卸载

~/.claude/skills/wechat-claude-code-installer/scripts/uninstall.sh

完全清掉 daemon + 上游项目 + 数据目录。本 skill 自身保留。

风险与免责

1. 微信账号风险：iLink AI 是腾讯官方通道，封号风险极低；但建议首次绑个人小号。
2. 数据流向：所有微信消息 → 本机 daemon → 你的 ANTHROPIC_BASE_URL → Claude。doctor 第 4 步会提醒。
3. 本机权限：daemon 等同"坐在你电脑前的人"——能跑命令、读文件、改文件。不要把绑定的微信号借给别人。
4. 本 skill 不修改上游代码，所有改动都在 launchd plist + session.json，可随时回滚。
5. 上游 1.0.0 还在迭代；本 skill 修法基于 1.0.0，未来版本可能不需要。

参考

• 上游：Wechat-ggGitHub/wechat-claude-code
• 灵感原文：「在你微信里用爽 Claude Code」（公众号「逛逛GitHub」，2026-06）

License

MIT。本 skill 是上游项目的安装与配置助手，不重新分发上游代码。