Skip to main content

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：重置当前会话上下文
  1. 后台常驻运行 开启微信连接之后，电脑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 微信连接完整使用教程

前置条件：

    已经正常运行 codex‑cli，config.toml配置正常（可以直连OpenAI或对接LiteLLM网关），本地控制台可以正常对话，无会话中断报错。 Codex++版本 ≥ v1.2.48，旧版本没有微信连接功能。 Windows已装好VC++运行库，程序可以正常启动。

    一、开启微信连接步骤

      打开 codex‑plus‑plus‑manager.exe 主界面 在侧边栏找到 微信连接 标签页，点击 启动微信桥接 程序窗口内会出现微信登录二维码。

      ⚠️ 使用手机微信扫码登录（PC微信不要登录同一个账号，协议冲突），推荐小号测试，不建议日常大号长期挂。

      手机微信确认登录，管理器页面提示：微信桥接已运行。 关键：给自己这条微信发一条消息，完成会话初始化，此时桥接链路正式打通。

      运行后：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的特别注意点（你现在的环境）

        Codex‑CLI 的config.toml必须配置好openai_base_url指向http://127.0.0.1:4000/v1，wire_api = "responses"，litellm开启enable_responses_api: true。 下游模型必须支持工具调用（function‑call）。国产模型工具调用能力弱，微信端会频繁报 Conversation interrupted会话中断。 /model后面写的模型名必须和litellm配置model_list的model_name完全一模一样，大小写不能错，否则返回400模型不存在错误。

        四、安全配置（非常重要）

          默认状态下，扫码登录的这个微信号才有执行权限，其它微信消息全部会被拒绝，不会执行指令。不要修改配置开放给其他人，微信下发指令可以读写本地磁盘、运行命令，风险极高。 不要登录微信PC版和桥接为同一个账号，会冲突掉线。 电脑睡眠、关机、断网，微信不会收到回复。如果要24小时运行，需要关闭Windows自动睡眠。

          五、常见故障排查

            扫码成功，微信发消息没有任何回复
              确认codex‑cli本身在本机控制台可以正常对话。 检查manager窗口日志，看是否有报错； 重启微信桥接，重新发一条消息初始化会话。 频繁会话中断 Conversation interrupted
                绝大多数是模型工具调用兼容问题。LiteLLM代理开启responses，但底层模型不支持工具调用。优先换OpenAI官方模型测试确认链路是否正常。 微信桥接频繁掉线
                  不要同时登录PC微信；网络波动会掉线，重新扫码登录即可。 更换模型不生效
                    微信发送/status确认当前模型；名字严格匹配Litellm model_list。

                    六、停止微信桥接

                    两种方式：

                      在Codex++管理器微信连接页面，点击停止微信桥接 直接关闭整个codex‑plus‑plus‑manager.exe程序，桥接立刻终止。

                      桥接配置保存在codex++的配置目录，重启程序需要手动重新点启动桥接、重新扫码。

                      如果你需要，我可以简单写一份微信连接开启、以及微信端可用斜杠指令速查表。我可以给你一份最小可直接复制的codex config.toml + litellm_config.yaml适配微信桥接。

                      Back to top