摘要本文使用 Linco Bridge 的官方在线 Demo完整走一遍“手机端生成连接配置→电脑安装并启动linco-connect→确认 Codex 在线→发送第一条只读任务”的流程。文末附常见排障方法和安全边界。关键词Codex CLI、Linco Bridge、linco-connect、AI Agent、跨设备会话、WebSocket1. 这篇教程要跑通什么Codex 在电脑上跑任务时人不一定能始终守着终端。比如任务执行到一半你只想看看进度、补充一句要求或处理一个权限确认这时再打开远程桌面并不算轻便。Linco Bridge 的思路是Codex 继续在你的电脑上执行linco-connect负责把会话、流式输出、权限请求和文件引用桥接到手机、H5 或自定义客户端。这篇不展开讲协议和二次开发目标很具体使用在线 Demo从零安装linco-connect让手机端看到本机 Codex并发送第一条只读任务。2. 开始前的环境检查先确认两件事电脑上的 Codex CLI 已经能正常启动和登录。Node.js 版本在 Linco Bridge 当前支持范围内。打开电脑终端执行node-vcodex--version当前的 Node.js 支持范围是20 或 22–26推荐使用Node.js 22 LTS。Node.js 21 不在当前支持范围内因为连接器依赖原生模块better-sqlite3。截至 2026-07-28项目文档中记录的 Codex CLI 已验证版本为codex-cli 0.142.5这表示项目对该版本做过验证不代表其他版本必然不能使用。如果正好在排查兼容性问题请先对齐文档记录的已验证版本。3. 打开手机端体验入口有两个公开入口在线 H5https://bridge-demo.lincotalk.com微信小程序搜索agent桥接器打开后进入底部的“桥接”页面选择从 Codex 导入。这个页面同时会显示 Claude Code、Hermes 和 OpenClaw本文只演示 Codex。它们的操作都是一样的大家可以根据自己平时使用的是哪个选择性的去连接就行都能做到随时随地的续聊。4. 生成并复制本机连接配置进入“连接 Codex”页面后会看到三条命令全局安装linco-connect使用页面生成的 Token、Account 和 WSS 地址初始化 Codex 连接在后台启动连接器。命令的结构大致如下。下面只是脱敏格式不要直接复制这个示例npminstall-glinco-connect linco-connect init\--token页面生成的-app-id:app-secret\--agentcodex\--channellinco-demo\--account页面生成的-account-id\--ws-url wss://bridge-demo.lincotalk.com/bridge/ws/codex linco-connect start--daemon请点击页面上的“复制”把页面实际生成的完整命令复制到运行 Codex CLI 的电脑上。注意命令中包含动态 App Secret。不要把完整命令发到公开群聊、论坛、Issue 或未脱敏截图中。如果你在手机上复制命令请通过自己可信的方式传到目标电脑不要经过公开聊天或可被他人访问的协作文档。5. 在电脑上执行三条命令把页面生成的命令粘贴到电脑终端中执行。第一条命令安装连接器npminstall-glinco-connect第二条命令会将当前 Codex 账号的桥接配置写入本机。默认配置位置在用户目录下的.linco/config.json普通用户不需要手动修改这个文件。第三条命令在后台启动连接器linco-connect start--daemon如果想先在前台看启动输出也可以使用linco-connect start前台模式便于第一次排查问题确认没问题后再使用--daemon转到后台。6. 检查连接器是否正常执行linco-connect status linco-connect doctorstatus用于查看连接器当前运行状态doctor用于检查本机环境和 CLI 状态。然后回到手机或 H5 页面。完成本机配置并连接成功后Codex 会自动出现在 Agent 列表中。建议在这一步确认三个结果桥接状态显示在线能够进入 Codex 的项目或会话列表发送消息后能收到流式回复。7. 发送第一条跨端任务第一次连接建议不要马上让 Codex 改代码。先发送一条只读任务确认项目、会话和流式输出都正常请只读取当前项目告诉我它的主要技术栈、启动入口和顶层目录作用。 这一轮不要修改文件也不要安装依赖。这条任务足够验证手机端消息能否送达电脑上的 CodexCodex 能否正确读取当前项目回复能否流式返回手机端当前项目与会话路由是否正确。如果手机端开始持续显示 Codex 输出并最终返回项目概览第一个跨端会话就跑通了。8. 五个常见问题8.1 终端提示linco-connect: command not found先确认全局安装命令执行成功npminstall-glinco-connect如果安装成功但命令仍找不到检查 npm 全局可执行目录是否已加入当前 Shell 的PATH。8.2 升级 Node.js 后出现better-sqlite3或NODE_MODULE_VERSION报错优先切换到 Node.js 22 LTS然后重新安装linco-connect。如果是在源码目录中运行也可以在对应安装目录重新执行npm install或重建better-sqlite3。8.3 连接器在运行页面仍显示离线按这个顺序检查执行linco-connect status和linco-connect doctor回到当前桥接页重新复制最新的setupCommands确认--agent codex、--channel linco-demo和--account没有被手动改动检查本机防火墙、代理或公司网络是否拦截了页面生成的 WSS 连接。访客凭证可能变化不要长期复用以前截图或文档中的旧命令。8.4 会话列表为空先确认电脑上的 Codex 已经有本地项目或会话记录。还需要确认当前 Codex 版本处于连接器适配范围内且会话索引刷新没有失败。8.5 提示凭证已占用每套凭证通常只绑定一个桥接实例。可以停止原来的桥接或者在页面中点击“新增连接”生成新的 Account 和 Token。9. 停止或重载连接器停止后台服务linco-connect stop修改账号配置后手动重载linco-connect reload重新启动linco-connect start--daemon10. 不要忽略在线 Demo 的边界在线 Demo 使用签名匿名访客 Session用来快速验证桥接流程。它不提供正式账号、持久跨设备恢复或生产级多租户保证。因此不要输入敏感数据或正式业务数据不要分享 Token、App Secret 和带凭证的 URL公网链路使用 TLS/WSS 不等于系统已实现端到端加密需要接入真实数据时应评估并部署自己的参考平台或自定义通道。11. 开发者扩展本地部署参考平台如果已经跑通在线 Demo下一步想看源码或自己联调可以在两个终端分别启动服务端和 H5。终端一cdlinco-bridge-platform/servernpminstallnpmrun start:dev终端二cdlinco-bridge-platform/webnpminstallnpmrun dev:h5打开 H5 页面再次进入“桥接→从 Codex 导入”以页面生成的setupCommands为准。本地linco-demo默认通常使用ws://127.0.0.1:3300/bridge/ws/codex这个地址只适合可信的本地开发环境因此本地生成的初始化命令中可能包含--allow-insecure-ws。公网部署不应使用这个参数。12. 项目入口GitHubhttps://github.com/lincotalk/linco-bridge在线 Demohttps://bridge-demo.lincotalk.com小程序搜索agent桥接器快速开始https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/quick-start.md排障文档https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/troubleshooting.md安全与隐私https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/security-and-privacy.md《Linco Bridge 开源在手机端续接 Codex、Claude Code 、Hermes等本地 AI Agent架构与实践》
摘要本文使用 Linco Bridge 的官方在线 Demo完整走一遍“手机端生成连接配置→电脑安装并启动linco-connect→确认 Codex 在线→发送第一条只读任务”的流程。文末附常见排障方法和安全边界。关键词Codex CLI、Linco Bridge、linco-connect、AI Agent、跨设备会话、WebSocket1. 这篇教程要跑通什么Codex 在电脑上跑任务时人不一定能始终守着终端。比如任务执行到一半你只想看看进度、补充一句要求或处理一个权限确认这时再打开远程桌面并不算轻便。Linco Bridge 的思路是Codex 继续在你的电脑上执行linco-connect负责把会话、流式输出、权限请求和文件引用桥接到手机、H5 或自定义客户端。这篇不展开讲协议和二次开发目标很具体使用在线 Demo从零安装linco-connect让手机端看到本机 Codex并发送第一条只读任务。2. 开始前的环境检查先确认两件事电脑上的 Codex CLI 已经能正常启动和登录。Node.js 版本在 Linco Bridge 当前支持范围内。打开电脑终端执行node-vcodex--version当前的 Node.js 支持范围是20 或 22–26推荐使用Node.js 22 LTS。Node.js 21 不在当前支持范围内因为连接器依赖原生模块better-sqlite3。截至 2026-07-28项目文档中记录的 Codex CLI 已验证版本为codex-cli 0.142.5这表示项目对该版本做过验证不代表其他版本必然不能使用。如果正好在排查兼容性问题请先对齐文档记录的已验证版本。3. 打开手机端体验入口有两个公开入口在线 H5https://bridge-demo.lincotalk.com微信小程序搜索agent桥接器打开后进入底部的“桥接”页面选择从 Codex 导入。这个页面同时会显示 Claude Code、Hermes 和 OpenClaw本文只演示 Codex。它们的操作都是一样的大家可以根据自己平时使用的是哪个选择性的去连接就行都能做到随时随地的续聊。4. 生成并复制本机连接配置进入“连接 Codex”页面后会看到三条命令全局安装linco-connect使用页面生成的 Token、Account 和 WSS 地址初始化 Codex 连接在后台启动连接器。命令的结构大致如下。下面只是脱敏格式不要直接复制这个示例npminstall-glinco-connect linco-connect init\--token页面生成的-app-id:app-secret\--agentcodex\--channellinco-demo\--account页面生成的-account-id\--ws-url wss://bridge-demo.lincotalk.com/bridge/ws/codex linco-connect start--daemon请点击页面上的“复制”把页面实际生成的完整命令复制到运行 Codex CLI 的电脑上。注意命令中包含动态 App Secret。不要把完整命令发到公开群聊、论坛、Issue 或未脱敏截图中。如果你在手机上复制命令请通过自己可信的方式传到目标电脑不要经过公开聊天或可被他人访问的协作文档。5. 在电脑上执行三条命令把页面生成的命令粘贴到电脑终端中执行。第一条命令安装连接器npminstall-glinco-connect第二条命令会将当前 Codex 账号的桥接配置写入本机。默认配置位置在用户目录下的.linco/config.json普通用户不需要手动修改这个文件。第三条命令在后台启动连接器linco-connect start--daemon如果想先在前台看启动输出也可以使用linco-connect start前台模式便于第一次排查问题确认没问题后再使用--daemon转到后台。6. 检查连接器是否正常执行linco-connect status linco-connect doctorstatus用于查看连接器当前运行状态doctor用于检查本机环境和 CLI 状态。然后回到手机或 H5 页面。完成本机配置并连接成功后Codex 会自动出现在 Agent 列表中。建议在这一步确认三个结果桥接状态显示在线能够进入 Codex 的项目或会话列表发送消息后能收到流式回复。7. 发送第一条跨端任务第一次连接建议不要马上让 Codex 改代码。先发送一条只读任务确认项目、会话和流式输出都正常请只读取当前项目告诉我它的主要技术栈、启动入口和顶层目录作用。 这一轮不要修改文件也不要安装依赖。这条任务足够验证手机端消息能否送达电脑上的 CodexCodex 能否正确读取当前项目回复能否流式返回手机端当前项目与会话路由是否正确。如果手机端开始持续显示 Codex 输出并最终返回项目概览第一个跨端会话就跑通了。8. 五个常见问题8.1 终端提示linco-connect: command not found先确认全局安装命令执行成功npminstall-glinco-connect如果安装成功但命令仍找不到检查 npm 全局可执行目录是否已加入当前 Shell 的PATH。8.2 升级 Node.js 后出现better-sqlite3或NODE_MODULE_VERSION报错优先切换到 Node.js 22 LTS然后重新安装linco-connect。如果是在源码目录中运行也可以在对应安装目录重新执行npm install或重建better-sqlite3。8.3 连接器在运行页面仍显示离线按这个顺序检查执行linco-connect status和linco-connect doctor回到当前桥接页重新复制最新的setupCommands确认--agent codex、--channel linco-demo和--account没有被手动改动检查本机防火墙、代理或公司网络是否拦截了页面生成的 WSS 连接。访客凭证可能变化不要长期复用以前截图或文档中的旧命令。8.4 会话列表为空先确认电脑上的 Codex 已经有本地项目或会话记录。还需要确认当前 Codex 版本处于连接器适配范围内且会话索引刷新没有失败。8.5 提示凭证已占用每套凭证通常只绑定一个桥接实例。可以停止原来的桥接或者在页面中点击“新增连接”生成新的 Account 和 Token。9. 停止或重载连接器停止后台服务linco-connect stop修改账号配置后手动重载linco-connect reload重新启动linco-connect start--daemon10. 不要忽略在线 Demo 的边界在线 Demo 使用签名匿名访客 Session用来快速验证桥接流程。它不提供正式账号、持久跨设备恢复或生产级多租户保证。因此不要输入敏感数据或正式业务数据不要分享 Token、App Secret 和带凭证的 URL公网链路使用 TLS/WSS 不等于系统已实现端到端加密需要接入真实数据时应评估并部署自己的参考平台或自定义通道。11. 开发者扩展本地部署参考平台如果已经跑通在线 Demo下一步想看源码或自己联调可以在两个终端分别启动服务端和 H5。终端一cdlinco-bridge-platform/servernpminstallnpmrun start:dev终端二cdlinco-bridge-platform/webnpminstallnpmrun dev:h5打开 H5 页面再次进入“桥接→从 Codex 导入”以页面生成的setupCommands为准。本地linco-demo默认通常使用ws://127.0.0.1:3300/bridge/ws/codex这个地址只适合可信的本地开发环境因此本地生成的初始化命令中可能包含--allow-insecure-ws。公网部署不应使用这个参数。12. 项目入口GitHubhttps://github.com/lincotalk/linco-bridge在线 Demohttps://bridge-demo.lincotalk.com小程序搜索agent桥接器快速开始https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/quick-start.md排障文档https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/troubleshooting.md安全与隐私https://github.com/lincotalk/linco-bridge/blob/main/docs/zh-CN/security-and-privacy.md《Linco Bridge 开源在手机端续接 Codex、Claude Code 、Hermes等本地 AI Agent架构与实践》
