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不能关闭、不能最小化到托盘退出，窗口最小化可以，关闭程序微信桥接直接断开。

二、微信端可用斜杠指令（直接微信聊天框发送）

普通用法示例（不需要斜杠，直接发自然语言）

读取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适配微信桥接。