# 文章深度拆解报告

> 来源：微信公众号「星河里的小黄鱼」《把 Claude Code 装进微信：Windows 完整接入教程》
> 原文链接：https://mp.weixin.qq.com/s/lRZWV_G0o3-RqezWwlRpFQ
> 抓取时间：2026-06-19T19:22:59+08:00
> 版权标注：本文内容提炼自上述公众号文章，仅用于个人学习与非商用场景，禁止二次传播。

---

## 一、文章全量元数据档案

| 条目 | 内容 |
|---|---|
| 文章标题 | 把 Claude Code 装进微信：Windows 完整接入教程 |
| 作者/公众号 | 星河里的小黄鱼 |
| 原文链接 | https://mp.weixin.qq.com/s/lRZWV_G0o3-RqezWwlRpFQ |
| 抓取时间 | 2026-06-19T19:22:59+08:00 |
| 文章 ID | lrzwv-g0o3-rqezwwlrpfq |
| 发布日期 | unknown |
| 核心主题 | 在 Windows 上将 Claude Code 作为后端、AI 作为大脑、微信作为入口的便携式 AI 编码助手部署方案 |
| 完整覆盖范围 | 环境门槛、5 步安装、权限模式选择、链路架构图、卸载回滚 SOP、patch-exe.cjs 补丁脚本、start.ps1 启动脚本附录 |
| 提取完整度 | 全文结构、关键命令、脚本核心逻辑已完整提炼；冗余描述、客套话已剔除 |
| 版权标注 | 仅用于个人学习，禁止商用 |

---

## 二、文章核心方法论深度拆解

### 1. 核心底层逻辑

文章围绕**「把命令行 Agent 嵌入即时通讯入口」**这一思路展开。微信天然具备移动端、消息收发、文件/图片支持，是个人触达 AI 的最佳前台；Claude Code 是当下最强的本地编码 Agent 后端；MCP（Model Context Protocol）作为中间协议，让 WeChat 通道以 Server 形式挂载到 Claude Code 的 Channel 系统里。

三层架构：
- **入口层**：微信 + ClawBot 插件（用户在手机端零成本触达）
- **通道层**：cc-wechat（MCP Server，长轮询拉消息）+ Claude Code 原生 exe（开启 Channels）
- **推理层**：Anthropic API 或 DeepSeek 等 OpenAI 兼容 API（可在 CLI 端切换）

### 2. 核心知识点/技能点

按文章讲解顺序逐条提炼：

| 序号 | 知识点 | 关键参数/结论 |
|---|---|---|
| K1 | CLI 自检 | `claude --version`；失败时 `npm i -g @anthropic-ai/claude-code` |
| K2 | 微信通道安装 | `npx -y cc-wechat@latest install`，弹出二维码，扫码后凭据本地保存 |
| K3 | 灰控解锁（非 Max 必备） | claude.exe 内 `tengu_harbor` 功能开关默认返回 `!1`（关闭），需 patch 为 `!0` |
| K4 | 补丁实现 | Node.js 脚本按 `latin1` 编码读取二进制、定位特征串 `function X(){return Y("tengu_harbor",!1)}`、就地替换为 `!0` |
| K5 | 启动参数 | `server:wechat-channel --permission-mode acceptEdits` + 开发通道开关 |
| K6 | 权限模式取舍 | acceptEdits 是「流畅 vs 安全」最优平衡点；默认 confirm 模式打断微信节奏；bypassPermissions 风险过高 |
| K7 | 常驻与自愈 | PowerShell `while($true)` 循环 + `Start-Process -Wait` 失败后 5 秒重启 |
| K8 | 卸载回滚 | 还原 `.bak` 备份 + `claude mcp remove wechat-channel -s user` |

### 3. 完整操作流程（5 步）

1. **Step 1 - CLI 自检**：`claude --version`，失败重装。
2. **Step 2 - 装通道**：`npx -y cc-wechat@latest install`，扫码登录。
3. **Step 3 - 破解灰控**：运行 patch-exe.cjs，把 `tengu_harbor` 从 `!1` 改 `!0`；生成 `.bak` 备份与 `.patched` 输出。
4. **Step 4 - 写启动脚本**：start.ps1 调用 claude.exe 并加载 wechat-channel、acceptEdits、循环自启。
5. **Step 5 - 启动并验证**：`powershell -ExecutionPolicy Bypass -File start.ps1`，微信搜「微信 ClawBot」发首条消息。

### 4. 核心工具/模型/Skill 详解

| 工具 | 核心能力 | 调用方法 | 适配场景 | 限制 |
|---|---|---|---|---|
| cc-wechat | 微信长轮询 MCP Server | `npx -y cc-wechat@latest install` | 个人微信 → Agent 通道 | 需微信端启用 ClawBot 插件 |
| patch-exe.cjs | 二进制就地 patch | `node patch-exe.cjs` | 解锁 Claude Code 灰度功能 | 修改客户端文件，违反 ToS 风险 |
| start.ps1 | 一键常驻 + 自愈 | `powershell -ExecutionPolicy Bypass -File start.ps1` | 7×24 微信端 AI 后台 | 仅 Windows；需保持终端运行 |
| Claude Code | 原生 CLI Agent | `--dangerously-load-development-channels server:wechat-channel` | 编码/查询/文件处理 | 需 Max 订阅或 patch 解锁 |
| 兼容 API（DeepSeek/Claude） | 模型推理 | 通过 Claude Code CLI 端切换 | 降本/差异化能力 | 受模型能力差异约束 |

### 5. 原文核心代码/配置/模板全量复刻（结构骨架）

**patch-exe.cjs 结构骨架**（关键逻辑摘录，非完整脚本）：
- 路径常量：`EXE_PATH = $APPDATA/npm/node_modules/@anthropic-ai/claude-code/bin/claude.exe`
- 补丁表：`[{ desc: 'Channels feature flag (tengu_harbor)', regex: /function(\w+)\(\)\{return(\w+)\("tengu_harbor",!1\)\}/, isPatched 校验 }]`
- 备份：第一次运行自动生成 `claude.exe.bak`
- 写入策略：原位写入失败时降级到 `claude.exe.patched`，提示手动 `Move-Item` 覆盖
- 编码：全程 `latin1`，避免中文路径与二进制混淆

**start.ps1 结构骨架**（关键逻辑摘录）：
- 窗口标题：`-WindowTitle "ClawBot"`（任务栏可识别）
- 启动参数：`-ArgumentList "--dangerously-load-development-channels","server:wechat-channel","--permission-mode","acceptEdits"`
- 进程模式：`-NoNewWindow -Wait -PassThru`，前台等待子进程
- 自愈循环：`while($true)` + 退出码提示 + `Start-Sleep 5`
- 颜色输出：Cyan 边框、Green 标题、Yellow 时间、Red 告警

> 完整代码请回到原文附录自行复制使用。

---

## 三、可直接落地·开箱即用执行方案

### 1. 标准化执行 SOP

详见输出字段 `sop`。

### 2. 可直接复制的即用素材包

**预置命令清单**：
- 自检：`claude --version`
- 通道：`npx -y cc-wechat@latest install`
- 补丁：`node patch-exe.cjs`
- 启动：`powershell -ExecutionPolicy Bypass -File start.ps1`
- 移除：`claude mcp remove wechat-channel -s user`
- 恢复：`Move-Item -Force claude.exe.bak claude.exe`

**关键配置参数（按字段）**：
- MCP 通道名：`wechat-channel`
- 权限模式：`acceptEdits`
- 开发通道开关：`--dangerously-load-development-channels`
- 二进制特征串：`function X(){return Y("tengu_harbor",!1)}`
- exe 路径：`$env:APPDATA\npm\node_modules\@anthropic-ai\claude-code\bin\claude.exe`

### 3. 可复用工作流框架

```
[微信 ClawBot 插件]
   ↓ (长轮询消息)
[cc-wechat MCP Server] ←── 凭据本地存储
   ↓ (MCP Channel 协议)
[Claude Code 原生 exe (Channels + tengu_harbor 补丁)]
   ↓ (Anthropic 兼容 API)
[Claude / DeepSeek / 其他模型]
   ↑
[结果原路返回微信]
```

### 4. 适配 OPCX 本地落地方案

- **Skill 形态**：可封装为 OPCX 的 `wechat-clawbot-bridge` Skill，输入为微信消息、输出为 Agent 任务。
- **节点配置**：复用 OPCX 已有的 `mcp-server` 节点，channel 名固定 `wechat-channel`，权限模式默认 `acceptEdits`。
- **环境要求**：Windows + Node 22+ + PowerShell 5.1+ + 已启用微信 ClawBot 插件。
- **降级方案**：若无法 patch，使用 `claude --print` 直连 CLI + 微信 Webhook 反向投递作为兜底。

### 5. 原文避坑红线

- 二进制 patch 修改客户端文件，存在违反 Anthropic ToS 风险，仅个人学习使用。
- 必须先关闭所有 Claude Code 窗口再 patch，否则文件被占用会降级到 `.patched`，需手动覆盖。
- 微信需在「我 → 设置 → 插件」中先启用 ClawBot，否则 npx install 完成后无法收到消息。
- 终端关闭 = 微信断连，必须保持 start.ps1 窗口运行（可最小化）。
- 第一次运行 Claude Code 会弹安全警告，需手动确认。
- acceptEdits 会自动接受文件编辑类操作，危险指令需在 Prompt 层加防御。

---

## 四、OPCX 专属学习投喂包

### 1. 核心能力学习点

- **CLI Agent 多入口扩展模式**：如何把单一 CLI 工具通过 MCP Channel 协议扩展到 IM 入口。
- **二进制 patch 解锁灰度功能**：通过字符串特征码定位 + 长度对齐替换的就地修改范式。
- **崩溃自愈的常驻脚本模式**：`while($true) + Start-Process -Wait + 延时重启` 的三段式自愈模板。
- **权限模式分层决策**：confirm / acceptEdits / bypassPermissions 三档的取舍框架。

### 2. Skill 调用与适配逻辑

- **入参**：`{ user_id, message, channel: "wechat" }`
- **出参**：`{ reply_text, files, status }`
- **触发条件**：cc-wechat 推送消息到 Claude Code
- **错误处理**：网络断连 → cc-wechat 自动重连；Agent 崩溃 → start.ps1 5 秒自愈

### 3. 工作流节点设计参考

```
[Node 1] 微信消息接收（cc-wechat）
   ↓
[Node 2] 权限校验（acceptEdits 自动放行 / 危险指令拦截）
   ↓
[Node 3] Claude Code Agent 任务派发
   ↓
[Node 4] 模型 API 调用（Claude / DeepSeek 切换）
   ↓
[Node 5] 结果回传微信（cc-wechat）
```

### 4. OPCX 智能体角色设定 Prompt

详见输出字段 `prompts`。

### 5. 标准输入输出示例

```
[用户输入（微信）]
帮我写一个 Python 脚本，读取当前目录所有 .md 文件并统计字数

[OPCX 分步执行]
1. cc-wechat 接收微信消息
2. acceptEdits 模式下 Claude Code 派发 Agent 任务
3. 调起 Shell + Write 工具，写入 word_count.py
4. 运行脚本并回传结果

[标准输出（微信）]
已完成。脚本路径：C:/work/word_count.py
统计结果：
  README.md → 1234 字
  notes.md → 567 字
```

---

## 五、可复用延伸应用场景

### 场景 1：移动端编码助手
- 场景用途：通勤、差旅途中用手机微信让 AI 写代码、修 Bug
- 执行思路：cc-wechat + Claude Code + DeepSeek 降本组合
- 适配 OPCX/Claude Code 使用方式：复用 start.ps1，权限模式 acceptEdits
- 预期落地效果：手机端零摩擦触发编码任务，文字/图片/文件双向收发

### 场景 2：家庭 / 团队共享 AI 网关
- 场景用途：把微信 ClawBot 暴露给家人或小团队成员，共享个人 AI 配额
- 执行思路：cc-wechat 多用户白名单 + Claude Code 多 session 隔离
- 适配 OPCX/Claude Code 使用方式：把 start.ps1 转为 systemd / NSSM 服务
- 预期落地效果：单一 Windows 节点服务多人，资源利用率最高

### 场景 3：长时任务夜间监控
- 场景用途：晚上发起批量重构/测试任务，微信端追踪进度
- 执行思路：Claude Code 后台长跑 + cc-wechat 推送中间结果
- 适配 OPCX/Claude Code 使用方式：与 OPCX `long-running-task` Skill 联动
- 预期落地效果：离线也能在微信端看到中间状态与最终交付

---

## 六、知识库标准化归档信息

| 维度 | 内容 |
|---|---|
| 一级归档分类 | AI Agent / 客户端扩展 / IM 通道接入 |
| 二级归档标签 | Claude Code、MCP 协议、Windows 部署 |
| 全量检索标签 | Claude Code、cc-wechat、tengu_harbor、acceptEdits、微信 ClawBot、二进制 patch、MCP Channel、PowerShell 自愈、灰度解锁、Anthropic ToS |
| 内容复用等级 | **高** |
| 判定依据 | （1）技术链路完整，可直接复刻部署；（2）附录脚本可直接使用；（3）回滚 SOP 完备；（4）适用面广（个人/家庭/团队）；（5）方法论可移植到其他 IM（Telegram/Discord） |
| 风险标签 | 二进制 patch 违反客户端 ToS，仅个人学习使用 |