简单的接入方式

如果你已经安装好了 Codex APP，可以直接把下面这句话发给 Codex：

https://github.com/Gan-Xing/CodexBridge 帮我对接个人微信

Codex 会自动处理后面的流程：克隆项目、安装依赖、检查环境、生成二维码、等待扫码、启动桥接服务。

扫码登录

依赖安装完之后，它会给你一个二维码。

用个人微信扫一下，然后在手机上确认登录就行。

这里注意一点：二维码有效期比较短。如果提示「二维码已过期」，让 Codex 重新生成一张再扫，不用纠结。

成功后怎么测试

扫码成功后，本机会生成微信账号凭证，通常在：

C:\Users\你的用户名\.codexbridge\weixin\accounts\

Windows 上还可以注册成计划任务，任务名一般是：

CodexBridge-Weixin

这样以后登录 Windows，它会自动启动。

接入成功后，打开微信，给桥接会话发：

/h

或者：

/status

如果能收到回复，说明链路已经通了。

后面就可以直接发自然语言任务，比如：

帮我看一下 D:\project2026\fuwari 这个项目最近有哪些改动，整理成一段提交说明。

常用命令

命令	作用
/h	查看帮助
/status	查看当前桥接状态
/new 路径	切换到新的项目目录
/threads	查看历史线程
/open 2	打开某个历史线程
/stop	停止当前正在跑的任务
/retry	重试上一条请求

日常远程使用，先记住这几个就够了。

几个注意点

一、Windows 脚本路径可能要改

项目自带的 .cmd 里可能写着作者自己的电脑路径，需要改成你本机的 Codex 路径和工作目录。

比如：

D:\software\Codex\app\resources\codex.exe
D:\zed-workspace

如果你是让 Codex 自动接入，它一般会自己检查并替你改掉。

二、二维码过期很正常

看到二维码就马上扫。过期了就重新生成。

三、电脑要保持在线

这个桥接不是云服务。CodexBridge 跑在你本机上，所以电脑关机、睡眠、断网，微信就收不到回复。

如果打算长期使用，建议关闭自动睡眠，并用 Windows 计划任务保持服务常驻。

四、注意权限边界

微信消息最后会变成 Codex 在你电脑上的任务，所以不要随便开放给别人用。建议只处理私聊，群聊默认关闭，或者只允许指定用户。

适合什么场景

它不是为了替代 Codex APP，而是给 Codex 多开了一个入口。

电脑端适合认真操作，微信端适合随手派活。

比如你在外面突然想到一个需求、一段文案、一个代码修改点，就可以直接发给微信里的 Codex。只要电脑在线，它就能在背后继续干活。