# Codex++（Codex‑plus‑plus‑manager）微信连接功能 > 注意：**这不是OpenAI官方Codex功能，是Codex++第三方增强工具的扩展**。 原理：扫码登录个人微信，做消息桥接：**手机微信作为远程输入入口，指令交给本地电脑上运行的Codex‑CLI/Codex App执行，结果再回传到微信**，AI的全部算力、文件读写都还是跑在你Windows本机上。 ## ✨主要作用 1. **手机微信远程操控本地Codex（核心）** 手机微信发文字指令，电脑上的Codex执行：写代码、查日志、生成脚本、命令行操作、文件读写，执行完成把结果、代码片段直接回复到微信聊天窗口。 > 例如：手机发：`帮我看D:\log下的报错日志，整理问题点`，电脑Codex读取本地文件，整理完把结果回微信发给你。 2. **每个微信联系人独立隔离会话** 不同微信私聊/好友自动映射独立Codex会话，上下文互不干扰；每个微信对话对应电脑上一套独立会话、工作目录，不会混上下文。 支持指令：`/new` 在微信里开启全新会话。 3. **消息透传，支持文本、文件** 微信发送文本、粘贴代码片段、上传文本文件，直接喂给Codex；Codex生成的长代码、输出日志可以直接在微信返回，大内容会做分片。 4. **可控制模型、切换工作目录（微信内发指令）** 在微信聊天框发斜杠指令远程控制本地Codex实例： - `/model qwen3.7‑max`：远程切换模型（对接LiteLLM的模型也生效） - `/dir D:\project`：切换电脑上的工作目录 - `/reset`：重置当前会话上下文 5. **后台常驻运行** 开启微信连接之后，电脑Codex++在后台挂着，不需要你一直开着Codex CLI窗口；只要电脑开机、服务在线，手机微信随时下发任务。 ## 🧩整体数据流 ``` 手机微信消息 → Codex++微信桥接模块 → 转发给本机Codex‑CLI（可以是对接LiteLLM代理） Codex在电脑执行读写文件/命令 → 返回结果 → Codex++推送回微信 ``` ## ⚠️重要限制与风险（一定要看） 1. **是基于个人微信协议桥接，不是企业微信机器人API**，存在账号风控风险，不建议大号长期挂；优先用小号测试。 2. **权限很大**：微信下发的指令可以直接操作电脑本地磁盘、运行命令，**不要把这个微信会话开放给其他人，仅限自己使用**，否则别人微信发指令可以读写、修改你电脑文件。 3. 依赖Codex‑CLI本身的稳定性，如果你LiteLLM代理不稳定、模型不支持工具调用，微信端就会收到会话中断，和你截图`Conversation interrupted`是同源问题。 4. 微信连接 ≠ 把模型部署到微信；**所有运算、文件访问全部发生在你的Windows本机**，微信只是遥控器。 ## 📌常见踩坑 1. 启动微信连接前，要保证Codex++已经正常连通你的Codex‑CLI（能正常调用模型，例如LiteLLM代理已经调通）。 2. 扫码登录微信之后，**保持codex‑plus‑plus‑manager程序不要关闭**，关闭就断开微信桥接。 3. 如果对接LiteLLM国产模型，模型必须支持工具调用，否则微信发指令经常直接会话中断。 ## 区分两个容易混淆概念 - **Codex++微信连接**：manager内置自带的wechat桥接（你现在问的），开箱在manager面板一键开启扫码。 - **cx2wechat / Codex‑Bridge**：外部独立第三方桥接工具，需要额外npm安装，不属于Codex++内置功能。 # Codex‑plus‑plus‑manager 微信连接完整使用教程 > 前置条件： > > 1. 已经正常运行 **codex‑cli**，`config.toml`配置正常（可以直连OpenAI或对接LiteLLM网关），本地控制台可以正常对话，无会话中断报错。 > 2. Codex++版本 ≥ **v1.2.48**，旧版本没有微信连接功能。 > 3. Windows已装好VC++运行库，程序可以正常启动。 ## 一、开启微信连接步骤 1. 打开 `codex‑plus‑plus‑manager.exe` 主界面 2. 在侧边栏找到 **微信连接** 标签页，点击 **启动微信桥接** 3. 程序窗口内会出现微信登录二维码。 > ⚠️ 使用**手机微信扫码登录（PC微信不要登录同一个账号，协议冲突）**，推荐小号测试，不建议日常大号长期挂。 4. 手机微信确认登录，管理器页面提示：`微信桥接已运行`。 5. **关键：给自己这条微信发一条消息**，完成会话初始化，此时桥接链路正式打通。 > 运行后：`codex‑plus‑plus‑manager.exe`**不能关闭、不能最小化到托盘退出**，窗口最小化可以，关闭程序微信桥接直接断开。 ## 二、微信端可用斜杠指令（直接微信聊天框发送）
微信发送指令功能说明
`/help`输出全部可用指令帮助
`/new`开启全新Codex会话，清空上下文记忆
`/status`查询桥接状态：当前模型、工作目录
`/model qwen3.7‑max`远程切换模型（名字和codex config / litellm model\_list必须完全一致）
`/dir D:\MyProject`切换电脑本地工作目录，后续读写文件都在这个路径
`/retry`上一条会话中断（你截图的`Conversation interrupted`），重试上一次任务
`/reset`重置当前会话，重置工具状态
### 普通用法示例（不需要斜杠，直接发自然语言） ``` 读取D:\logs\app.log，找出报错，整理成要点 写一个powershell脚本，批量重命名该目录jpg文件 查看当前目录所有docker‑compose.yml，检查语法 ``` 手机发送后，**电脑本地Codex执行文件读写、命令调用**，结果会回传到微信。长输出会自动做消息分片返回。 > 每个微信私聊好友，自动分配**独立会话上下文**，互相隔离互不干扰。 ## 三、对接LiteLLM的特别注意点（你现在的环境） 1. Codex‑CLI 的`config.toml`必须配置好`openai_base_url`指向`http://127.0.0.1:4000/v1`，`wire_api = "responses"`，litellm开启`enable_responses_api: true`。 2. **下游模型必须支持工具调用（function‑call）**。国产模型工具调用能力弱，微信端会频繁报 `Conversation interrupted`会话中断。 3. `/model`后面写的模型名必须和litellm配置`model_list`的`model_name`**完全一模一样，大小写不能错**，否则返回400模型不存在错误。 ## 四、安全配置（非常重要） 1. 默认状态下，**扫码登录的这个微信号才有执行权限，其它微信消息全部会被拒绝，不会执行指令**。不要修改配置开放给其他人，微信下发指令可以读写本地磁盘、运行命令，风险极高。 2. **不要登录微信PC版和桥接为同一个账号，会冲突掉线。** 3. 电脑睡眠、关机、断网，微信不会收到回复。如果要24小时运行，需要关闭Windows自动睡眠。 ## 五、常见故障排查 1. **扫码成功，微信发消息没有任何回复** - 确认codex‑cli本身在本机控制台可以正常对话。 - 检查manager窗口日志，看是否有报错； - 重启微信桥接，重新发一条消息初始化会话。 2. **频繁会话中断 `Conversation interrupted`** - 绝大多数是模型工具调用兼容问题。LiteLLM代理开启responses，但底层模型不支持工具调用。优先换OpenAI官方模型测试确认链路是否正常。 3. **微信桥接频繁掉线** - 不要同时登录PC微信；网络波动会掉线，重新扫码登录即可。 4. **更换模型不生效** - 微信发送`/status`确认当前模型；名字严格匹配Litellm model\_list。 ## 六、停止微信桥接 两种方式： 1. 在Codex++管理器微信连接页面，点击**停止微信桥接** 2. 直接关闭整个`codex‑plus‑plus‑manager.exe`程序，桥接立刻终止。 > 桥接配置保存在codex++的配置目录，重启程序需要手动重新点启动桥接、重新扫码。 如果你需要，我可以给你一份最小可直接复制的codex config.toml + litellm\_config.yaml适配微信桥接。