如何用 CodexAir 在手机上管理电脑中的 Codex 会话、项目和审批？

CodexAir 可以把 Android 手机或网页控制台变成电脑上 Codex 的移动管理入口，用于查看任务进度、继续线程、管理项目和处理审批。真正的代码、依赖、Codex 登录状态与工具链仍留在电脑、Mac mini 或服务器上；本机 CodexAir CLI Agent 负责连接 Relay 和 Codex app-server，手机只呈现适合决策的状态。

基本使用流程是：先在执行端安装并认证 Codex CLI，再全局安装 CodexAir CLI，运行 codexair 完成连接；随后安装 Android App 或打开网页控制台，选择电脑、项目和线程。当前 npm 包版本为 0.6.5，更新可使用 codexair update。

部署前需要注意，官网目前只给出“保留运行所需信息”的概括说明，并明确完整隐私说明将后续补充。因此不能假定对话保存周期、日志范围、删除流程和加密边界已经有完整公开承诺。涉及敏感代码或组织合规时，应先向服务方确认这些细节，或限制使用范围。

CodexAir 的工作架构

CodexAir 由移动或网页控制端、Relay、本机 CLI Agent 和 Codex app-server 组成。Relay 负责登录、授权和多端同步；本机 Agent 与 Codex app-server 通信，延续实际工作上下文。手机发出的续聊和审批最终回到执行机器。

代码仓库不会因为打开手机控制台就自动复制到移动设备。手机界面按电脑、项目和线程组织状态，显示哪台电脑在线、哪个项目可用、任务是否运行。长日志和完整 diff 主要留在电脑端，移动端偏向进度和决策信息。

断线恢复采用快照与增量同步。手机离线或切换网络后，再次打开时回到最新进度，而不是重新启动 Codex。用户仍要核对任务是否已经完成、等待审批或失败，避免重复发送同一指令。

适合哪些使用场景

CodexAir 适合已经在电脑启动长任务、但需要离开键盘的开发者。手机可以跟进搜索、修改和测试进度，在 Codex 提出问题时补充上下文，在关键命令或文件写入前处理审批。

它也适合连接长期在线的 Mac mini 或开发服务器。代码和构建环境不必迁移，用户从移动端选择对应机器与项目即可。不过服务器端权限通常更高，必须使用专门开发账户和受限凭据。

手机不适合完成大型代码审查、复杂冲突处理和生产发布。移动控制用于监督和短决策，最终 diff、测试、提交与发布仍应回到完整开发环境。

电脑端需要准备什么

首先安装 Codex CLI，并完成账号或 API 配置。打开目标仓库运行一次简单任务，确认模型、文件权限和工具调用正常。CodexAir 不替代 Codex 认证，底层 CLI 无法运行时，移动端也无法启动有效会话。

其次准备明确的工作目录。不要让远程 Agent 默认落在用户主目录、下载目录或包含多个项目的宽泛根目录。使用具体 Git 仓库，并确认已有未提交修改，防止 Agent 覆盖用户工作。

最后检查电源和网络。执行机器必须持续在线，休眠、关机或网络断开都会让手机无法控制。长任务期间接通电源，设置合适的系统更新窗口，但不要为了远程便利取消锁屏认证。

如何安装 CodexAir CLI

电脑需要已安装 Node.js 与 npm。官网提供全局安装方式：

npm i codexair -g
codexair

安装前可以通过 npm 查看包版本和描述，确认名称为 codexair，功能是连接 Relay 与 codex app-server 的本地 Agent CLI。不要安装名称相近的第三方包。

运行 codexair 后，按终端提示完成本机注册或登录。命令可能需要访问用户的 Codex 状态，因此应以日常开发账户运行，不要使用 root 或系统管理员权限解决文件访问问题。

如果全局命令找不到，检查 npm 全局可执行目录是否在 PATH 中。图形终端、系统服务和登录 Shell 的 PATH 可能不同。先修正环境，不要把未知目录添加到可执行搜索路径。

Android App 怎样安装

官网提供 Android APK 下载入口。应从 CodexAir 官方下载页获取当前版本，核对域名、文件名和版本，不使用聊天群或网盘中的转存包。Android 提示允许未知来源安装时，只为当前可信来源临时授权，安装后关闭。

首次打开 App 后，使用与 Relay 关联的账号登录或按产品引导连接本机 Agent。检查显示的电脑名称、项目和线程是否与执行端一致。出现未知设备时立即退出并检查账号。

手机应启用设备锁、生物识别、系统更新和远程擦除。移动端能够处理 Codex 审批，手机遗失不仅意味着聊天记录风险，还可能让他人驱动电脑上的 Agent。

网页控制台怎样使用

除 Android App 外，官网还提供网页控制台入口。网页适合临时从平板或另一台电脑查看任务，但浏览器会带来会话保存、扩展和共享设备风险。只在可信设备使用，完成后退出账号。

浏览器密码同步不应保存高权限控制凭据。公共电脑、会议室设备和他人浏览器不适合登录。若必须临时使用，采用独立浏览器配置，结束后撤销会话并清理本地数据。

怎样连接电脑或服务器

本机运行 codexair 后，CLI Agent 连接 Relay，并与 Codex app-server 建立工作关系。移动端看到在线状态后，先选择正确机器。电脑、Mac mini 和服务器可以拥有相同项目名，设备标识必须清晰。

设备命名可以包含用途与环境，例如个人工作站、测试服务器，但不要写客户名称、内部域名或漏洞信息。生产与开发机器应使用不同权限和显著标识，避免手机误选。

连接失败时依次检查本机 CodexAir 进程、网络、登录状态和 Codex app-server。不要在手机连续点击创建任务，否则连接恢复后可能出现重复请求。

项目和线程如何组织

CodexAir 按电脑、项目和线程整理任务，减少不同环境混淆。进入任务前依次确认设备、项目路径和线程标题。相同仓库的不同工作树也应有清晰名称。

线程包含上下文和任务历史。离开电脑后继续同一线程，可以补充要求而不重开上下文。新需求若与原任务无关，应创建新线程，避免旧指令和约束干扰。

多个线程不能随意并行写同一工作目录。需要并行时使用独立 Git 工作树，并为每个线程指定范围。否则两个 Agent 可能覆盖文件、争抢端口或混淆测试结果。

怎样查看 Agent 状态

移动端显示哪台电脑在线、哪个项目可用、当前任务是否运行。设备在线只代表 Relay 能联系本机 Agent，不证明 Codex 正在取得进展。进入线程查看最新步骤和是否等待用户。

短时间没有输出可能是在运行测试或工具，也可能已经卡住。关注最后一个动作、持续时间和错误，而不是简单按输出频率判断。发现重复循环时及时中断。

完成状态只表示本轮结束。仍要检查测试退出码、文件变化和未完成事项。手机上的摘要不能替代电脑端完整日志。

如何从手机继续线程

打开目标线程后，可以补充上下文、调整方向或要求 Codex继续。移动输入应简短但具体，包括修改对象、禁止范围和验证方式。例如“只修复当前失败测试，不改接口，不安装新依赖，完成后汇报文件列表”。

不要只发送“继续”来处理一个高风险等待点。先阅读 Codex 的问题，再回答具体选项。语音输入可能误识别路径、数字和命令，涉及删除、发布或凭据时改用手工输入并复核。

手机离线期间任务可能已经推进。恢复后先等待增量同步完成，再发新指令。重复回答审批或重复提交任务可能造成二次执行。

审批应该怎样处理

官网说明，命令执行、文件写入和关键操作可以由用户在手机确认。审批前需要看到具体命令、参数、工作目录和影响文件。信息不足时拒绝，并让 Codex 解释。

只读状态查询、固定测试和格式检查通常风险较低；包安装、删除、提交、推送、外部发送和生产访问风险更高。后者不应因为用户正在通勤就降低标准，必要时暂停到回电脑。

移动审批仍受桌面操作系统权限影响。若本机 Agent 以高权限账户运行，一次误批可能访问大量数据。使用低权限账户、开发凭据、容器和沙盒限制实际影响。

断线恢复如何判断是否可靠

CodexAir 通过快照和增量同步恢复手机进度。测试时可以启动无害长任务，切换手机网络并关闭应用，再重新进入同一线程。确认期间输出按顺序补齐，没有创建第二个会话。

断线恢复的是控制界面，不是电脑灾难恢复。执行机器关机、进程崩溃或 Codex app-server退出时，手机无法凭快照继续执行。重要任务需要 Git 检查点、日志和可重跑测试。

长日志和 diff 在哪里看

官网明确把长日志和完整 diff 留在电脑端，手机呈现适合决策的信息。这减少了小屏阅读负担，也意味着不能仅凭手机完成全面审查。

移动端可以要求 Codex 输出按文件组织的摘要、测试结果和风险点。返回电脑后运行 Git 状态与差异工具，检查逻辑、配置、依赖和测试。安全相关变更必须逐行复核。

提交与发布应继续走正常代码审查和持续集成流程。CodexAir 是控制入口，不应成为绕过审查的快捷方式。

如何安全使用 Relay

官网说明 Relay 负责登录、授权和移动端同步，但当前公开页面没有完整描述传输加密、内容留存、日志字段、服务器位置与删除周期。不要自行补充这些承诺。

个人测试可使用无敏感仓库，避免在任务提示、项目名和日志中包含秘密。企业使用前应要求完整的数据流、加密、留存、访问控制、事件响应与账号撤销说明。

即使代码文件不离开电脑，对话、状态或审批元数据也可能需要 Relay 同步。风险评估不能只问“仓库是否上传”，还要问哪些消息经过服务端以及保留多久。

隐私说明当前有哪些不足

隐私页面目前只有简短陈述，称 CodexAir 只保留运行所需信息，并表示完整说明后续补充。它没有给出足以验证的数据类别、目的、保存期、删除入口和第三方处理者。

这不是证明产品不安全，但意味着公开证据不足。对高敏感项目，证据不足应被视为尚未满足合规要求，而不是默认无风险。可以等待政策完善、向服务方询问，或只处理公开测试代码。

如何控制本机权限

本机 CLI Agent 连接 Codex app-server，Codex 可以读写当前用户允许的文件和执行工具。创建独立开发账户，只授权具体仓库，不加载生产密钥。不要以管理员身份长期运行。

把发布、数据库迁移和生产操作分离到其他流程。移动线程只进行本地修改和测试，最终变更由持续集成或人工审核推进。这样即使移动账号被误用，也难以直接影响线上环境。

外部网页、Issue 和仓库文档中的命令属于不可信数据。Agent 不应因为文本要求就上传秘密或改变安全设置。移动审批时尤其要警惕无法完整显示的长命令。

如何更新 CodexAir

官网提供内置更新命令：

codexair update

也可以通过 npm 检查当前发布版本。升级前记录 CLI、Android App 和 Codex CLI 版本，避免在长任务中途更新。升级后用测试仓库验证连接、线程恢复、审批和断线同步。

若更新失败，不要用管理员权限反复覆盖。检查 npm 全局目录、文件所有者、网络和包完整性。受管设备遵循组织软件安装流程。

常见故障排查

运行 codexair 后手机看不到电脑

检查本机进程是否仍运行、账号是否一致、网络能否访问 Relay，以及系统时间是否正确。查看终端错误，不要只在手机刷新。

电脑在线但项目为空

确认 Codex CLI 在目标目录可运行，CLI Agent 的用户权限能够读取仓库，并检查当前工作目录。避免把宽泛主目录作为项目来源。

线程无法继续

查看 Codex app-server 是否退出、认证是否过期和原工作区是否移动。不要新建同名线程覆盖现场，先保存错误和当前 Git 状态。

手机显示进度落后

等待快照和增量同步，检查手机网络。以电脑上的实际进程、文件和日志为准。同步未完成时不要重复审批。

网页控制台在共享设备留下登录

立即退出所有相关会话，修改凭据并检查设备列表。清除浏览器 profile 和站点数据，不能只关闭标签页。

怎样撤销移动访问

手机遗失、不再使用或账号异常时，先停止本机 codexair 进程，阻断后续操作。然后从可用控制台退出或撤销设备，检查近期线程、审批和 Git 变更。

由于完整隐私与账号撤销文档尚未公开，实际界面若没有明确删除入口，应联系服务方确认，而不是假设卸载 App 等于服务端数据删除。敏感凭据按风险轮换。

推荐的使用检查表

开始前确认 Codex CLI 已认证、CodexAir CLI 来自正确 npm 包、Android App 来自官网、执行账户权限受限、项目是具体仓库、电脑不会意外休眠。连接后核对设备和项目，再用测试任务验证审批与断线恢复。

日常任务从电脑建立干净基线并启动，手机只查看进度、回答必要问题和处理边界明确的审批。复杂差异和高风险操作回电脑处理。结束后检查 Git、测试和日志，长期不用时停止本机 Agent 并撤销移动访问。

CodexAir 的价值是把 Codex 会话和决策带到手机，而不是替代完整开发环境。当前产品可以用于低风险测试和个人工作流，但在隐私政策补充完整之前，不应对数据留存与安全机制作超出公开证据的推断。