5分钟上手Remodex：从零配对到发出第一条Codex指令的完整教程

5分钟上手Remodex从零配对到发出第一条Codex指令的完整教程【免费下载链接】remodexRemote Control for Codex.项目地址: https://gitcode.com/gh_mirrors/re/remodexRemodex 是一款本地优先的开源桥梁 iOS 应用让你用 iPhone 远程控制 Mac 上的 Codex扫码配对一次之后就能在手机端实时下发 Codex 指令、观看流式响应甚至完成 Git 提交与推送。这篇完整教程带你从安装、配对到发出第一条 Codex 指令全程只需 5 分钟。一、Remodex 是什么把 Codex 装进口袋的远程遥控器Remodex 的架构非常简洁iPhone 应用 ↔ Mac 上的桥接服务bridge↔ Codex 运行时。你的 iPhone 只是遥控器所有真正的 AI 编码工作都在 Mac 本地完成 端到端加密配对与聊天密钥由设备本地保管 Codex 运行时在 Mac 上执行手机上实时流式显示进度 支持 Plan 模式、/subagents子代理、运行中插话Steer Git 操作直达手机commit、push、pull、切换分支 拍照/相册附件、完成通知、访问权限控制更多特性说明见 README.md。二、安装前准备3 个必备条件在开始之前请确认你的环境满足以下条件Mac 已安装 Node.js v18Codex CLI 已安装并登录——Remodex 不管理 OpenAI 凭据需要本地 Codex CLI 独立工作。在终端执行codex login status确认登录成功即可iPhone 上已安装 Remodex 应用App Store 或自行用 Xcode 构建源码Xcode 工程位于 CodexMobile/⚠️ 如果启动时报Missing environment variable: CODEX_API_KEY这是 Codex CLI 的配置问题先执行codex login再重启 Remodex。Remodex 手机端界面实时查看 Codex 回复、代码 Diff 与 Git 提交三、3 步安装从 Codex CLI 到启动桥接服务Remodex 应用内的引导页已经把步骤写得很清楚见 OnboardingView.swift照做即可第 1 步安装 Codex CLI如果尚未安装npm install -g openai/codexlatest第 2 步安装 Remodex 桥接npm install -g remodexlatest第 3 步启动并生成配对二维码remodex up在 macOS 上remodex up会自动安装并启动一个轻量级的launchd后台桥接服务在终端打印配对二维码且关闭终端后桥接仍在后台存活。其他系统上则以前台方式运行。如果你希望完全本地自托管自带中继 桥接仓库提供了启动脚本 run-local-remodex.sh一键启动本地 relay 并打印配对 QRgit clone https://gitcode.com/gh_mirrors/re/remodex cd remodex ./run-local-remodex.sh自托管中继的完整做法参考官方文档Docs/self-hosting.md。四、5 分钟配对iPhone 扫码一次永久信任打开 Remodex iOS 应用跟随引导页滑动到最后点击Scan with QR Code进入扫码界面用 iPhone 摄像头扫描 Mac 终端上显示的二维码扫码瞬间iPhone 与 Mac 桥接会完成一次安全的密钥交换X25519 临时密钥 Ed25519 签名 AES-256-GCM 加密通道流程实现在 QRScannerView.swift 中。配对成功后 iPhone 把这台 Mac 存为受信任设备写入 Keychain Mac 桥接在~/.remodex/device-state.json本地持久化身份 以后每次启动 App 都会自动重连无需再扫码⚠️ 两个易踩的坑不要用系统相机或第三方扫码工具扫配对码——普通相机可能把二维码内容当纯文本打开网页搜索而不是完成配对若需强制重新配对换手机、重置信任在 Mac 上执行remodex reset-pairing后重新remodex up五、发出第一条 Codex 指令 配对完成后回到 App 首页点击New Chat创建会话在输入框中描述需求比如修复 auth.ts 里的登录 bug点击发送立刻在手机上看到 Codex 的实时流式回复——分析过程、修改的文件、代码 Diff 全部同步显示满意后点击Commit Push直接在手机上完成 Git 提交与推送几个提升效率的用法Queue 排队Codex 还在跑时可以继续输入下一条指令排队执行Steer 转向运行中插话修正方向无需从头再来/subagents在手机上启动子代理并行工作权限控制默认On-Request每次审批切换Full access后自动批准运行时提示桌面接力手机上创建的会话会同步到 Mac 的 Codex 桌面应用点击接力按钮即可在 Mac 上继续六、常用命令速查表 命令作用remodex up启动桥接服务并打印配对二维码remodex status查看后台服务与配对状态remodex restart更新 npm 包后重启后台服务remodex stop停止后台桥接服务remodex reset-pairing清空配对状态下次需重新扫码remodex resume在 Mac 的 Codex.app 中打开最近一条会话remodex watch实时跟踪会话事件日志遇到问题时的排查顺序remodex status看服务是否在运行 →codex login status确认 Codex 已登录 → 网络不通时考虑用 Tailscale 等稳定私网纯局域网ws://直连在部分 iOS 设备上不稳定。写在最后到这里你已经完成了一次完整的 Remodex 之旅3 步安装、1 次扫码、1 条指令——从从零配对到在 iPhone 上指挥 Mac 上的 Codex 干活全程 5 分钟。所有 AI 执行与数据都留在你的 Mac 本地手机只是一个安全、端到端加密的遥控器。想深入了解代码结构桥接服务源码在 phodex-bridge/src/iOS 应用在 CodexMobile/CodexMobile/自托管架构设计见 SELF_HOSTING_MODEL.md。【免费下载链接】remodexRemote Control for Codex.项目地址: https://gitcode.com/gh_mirrors/re/remodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考