工作流里最常见的痛点是电脑不在身边但有需求想临时让 AI 帮忙查一段代码、跑一个脚本甚至让手机连上家里的开发机继续调试。Codex 作为一款命令行 AI 编程工具通常大家习惯在自己电脑上直接跑但遇到远程使用、多个设备轮换操作时网上资料比较零散。本文围绕“手机远程用 Codex”这个场景整理一套包含远程连接原理、Codex CLI 安装、多模型切换配置、手机终端接入、常见坑点排查的完整方案。内容覆盖从电脑到手机的使用链路无论你是想在自己笔记本上远程调试还是希望通过手机连接家中开发机继续写代码都能直接参考。1. Codex 是什么为什么需要远程使用1.1 从终端里的 AI 编程助手说起Codex 是 OpenAI 推出的命令行 AI 编程工具官方形态通常是codex命令。它不像网页聊天那样需要打开浏览器而是直接嵌入开发者日常工作流在终端里通过对话方式完成代码解释、补全、重构、脚本生成等任务。对经常使用终端的人来说这种交互方式更接近“在编辑器旁边多了一个懂代码的同事”。Codex 的核心使用方式就是两条在终端输入问题或需求。让 Codex 生成回答、代码片段或直接对项目文件进行修改。很多人的第一反应是这东西在自己电脑上装好直接跑不就行了确实单机使用是默认用法。但实际开发中会出现一些更复杂的场景比如回家后想继续处理公司电脑上的代码出差时手机需要临时连回办公室开发机或者你希望手机也能接入同一个模型配置而不是每次都在手机浏览器里重新登录一套网页工具。1.2 本地使用的限制与远程使用的意义本地使用 Codex 有两个天然限制限制一你必须在装有 Codex 的电脑前。限制二模型推理的环境、API Key 配置、生成的项目代码都留在那台电脑上。一旦离开这台电脑前面的工作就“够不着”了。手机虽然能装各种 AI 客户端但直接调用 Codex 的环境变量、模型配置、项目上下文却很麻烦。远程使用的核心价值是让你把“运行 Codex 的机器”看作一个可以随时登录的服务手机也好其他电脑也好只要网络能到达都能继续使用同样的配置和项目文件。1.3 手机远程使用的典型场景常见场景可以分成三类第一类是“手机 SSH 到电脑”这种最直接手机通过 SSH 登录开发机在终端里运行 codex 命令看到的还是那台机器上的文件系统和环境变量。第二类是“手机浏览器访问网页终端”在开发机上启动一个网页终端服务后手机浏览器直接打开网址等于把终端搬进浏览器。第三类是“手机调用远程 Codex 服务”这种方式更接近网关模式适合把 Codex 或兼容模型包装成 HTTP 接口手机端只负责发送请求。本文重点展开前两种因为对大多数人来说稳定性最高、最不依赖额外平台。第三种方式如果你想做可以在理解前两种的基础上自行扩展。2. 环境准备与整体方案2.1 整体架构本文采用的方案结构如下一台常开的电脑或服务器作为远程开发机。系统可以是 Windows、Linux 或 macOS但为了配置简单以下以 macOS 和 Linux 的命令行为主Windows 用户可以把命令对应到 WSL 或 PowerShell。手机上安装 SSH 客户端比如 Termius、JuiceSSH或者用系统自带终端。开发机安装 Codex CLI配置一个或多个模型 Provider。可选开发机安装网页终端服务方便手机浏览器直接访问。连接关系可以概括为手机通过 SSH 或浏览器访问开发机开发机上运行 Codex CLICodex 再访问对应的模型 API。2.2 需要的硬件与软件在进行下一步之前建议确认以下环境开发机建议 4GB 内存以上保证 Node.js 和模型请求过程不要太吃力。手机Android 或 iOS 都可以关键是能安装 SSH 客户端。开发机操作系统macOS / Linux / Windows WSL 均可用。Node.jsCodex CLI 通常依赖 Node.js 环境建议使用较新的 LTS 版本。具体版本以你安装 Codex 时的官方要求为准本文示例默认你已经具备 Node.js 环境。网络手机和开发机能在网络层面互相访问。最简单的场景是同一局域网如果不能在同一局域网需要借助远程通道或公网可达的跳板机后文会解释思路。2.3 远程访问的安全思路远程访问开发机时安全边界是必须先想清楚的问题。这里不涉及任何特殊工具只讲通用原则能走 SSH 密钥认证就不要只依赖密码认证。不要把 Codex 的 API Key 写死在手机终端里或公开配置中。如果手机和开发机不在同一局域网建议通过一台公网服务器做跳板而不是把开发机的 SSH 端口直接暴露到公网。开发机上的模型服务若绑定本地端口避免绑定到0.0.0.0尽量只监听127.0.0.1需要外部访问时再通过 SSH 端口转发或受控网关完成。安全原则会影响后面的配置方式先有这个意识后面操作才不会踩坑。3. 核心原理SSH 端口转发与终端接入3.1 SSH 不只是远程登录不少人以为 SSH 就是为了登录服务器敲命令其实 SSH 还有一个实用能力叫端口转发。端口转发可以简单理解为让本机某个端口的数据经过加密隧道送到远程机器上。比如在开发机上Codex 的模型网关默认监听本地端口。手机直接访问不了这个端口就可以让 SSH 把这个端口“借道”转发出来手机访问本机端口时数据实际被送到远程开发机的对应端口。这种模式对开发调试特别有用因为模型 API 和内部接口都不需要暴露到公网手机只和建立 SSH 通道的地址通信安全性更好。3.2 手机终端与 SSH 的关系手机上的 SSH 客户端本质上也是一个终端模拟器。只要你能通过 SSH 登录开发机就等于坐在开发机前面。手机屏幕上看到的虽然是触摸键盘但背后执行的命令、访问的文件、调用的环境变量都发生在开发机上。所以在手机端运行 Codex 时真正做计算的不是手机而是开发机。手机只负责把输入传给开发机再把开发机的输出展示出来。这也是远程开发的关键思想计算和配置留在高性能或环境完整的机器上终端可以随处移动。3.3 打通电脑与手机的关键步骤连接打通的核心要素有三个开发机有 SSH 服务。Linux 或 macOS 通常自带 OpenSSHWindows 可以用 WSL 内的 SSH。开发机有可到达的 IP 地址。局域网内是类似192.168.x.x的地址跨网络时需要通过公网跳板。手机端有可用的 SSH 客户端并知道目标机器的用户名、IP、端口和认证方式。这三个要素满足后手机到开发机的通道就建立起来了。后面所有 Codex 操作都建立在这个通道之上。4. 电脑端部署 Codex 与多模型配置4.1 安装 Codex CLI在开发机上执行安装步骤前建议先确认 Node.js 可用。node -v npm -v如果输出正常接着安装 Codex CLI。官方安装方式通常是 npm 全局安装具体命令以你查看官方文档时的说明为准一般形式类似npm install -g openai/codex安装完成后确认版本codex --version如果命令可以正常输出版本号说明安装成功。如果提示command not found很可能是 npm 全局目录没有加入 PATH可以根据系统提示把对应目录加入 PATH 后重试。4.2 配置 OpenAI 兼容模型Codex CLI 默认使用 OpenAI 的模型服务需要在环境变量中配置 API Key。例如在 macOS / Linux 下临时设置export OPENAI_API_KEY你的 API Key但更推荐的做法是写入 shell 配置文件比如~/.zshrc或~/.bashrc这样每次登录免去手动导出。不过要注意不要把 API Key 提交到 Git 仓库也不要直接写在手机 SSH 客户端里。Codex CLI 的配置文件一般会放在~/.codex/config.toml。这个文件用来定义模型、供应商、API 地址等。下面是一个基础示例先配置默认使用 OpenAI 官方模型model gpt-5 model_provider openai [model_providers.openai] name OpenAI base_url https://models.openai.com/v1 env_key OPENAI_API_KEY wire_api responses这里有几个关键参数需要解释model默认使用的模型名称。具体模型名要以你账户可用模型为准不要照搬网络上的过时名字。model_provider对应下方某个[model_providers.xxx]配置块表示使用哪一家模型服务。base_urlAPI 的基础地址。如果接入第三方模型这里换成第三方兼容地址。env_keyCodex 读取 API Key 时使用的环境变量名。wire_api请求协议格式常见有responses和chat两种。OpenAI 官方模型使用responses更合适接入部分第三方服务时可能需要改成chat取决于服务方兼容的是哪种 API 格式。4.3 接入 DeepSeek 等第三方模型很多人关心 Codex 能否接入 DeepSeek 等第三方模型答案是可以的前提是该模型服务提供了 OpenAI 兼容接口。下面是一个对接 DeepSeek 的配置示例model deepseek-chat model_provider deepseek [model_providers.openai] name OpenAI base_url https://models.openai.com/v1 env_key OPENAI_API_KEY wire_api responses [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY wire_api chat配置好之后在 shell 里设置 DeepSeek 的 Keyexport DEEPSEEK_API_KEY你的 DeepSeek API Key然后运行 Codexcodex进入交互界面后Codex 会按照config.toml中指定的model_provider去请求对应服务。如果默认模型和供应商没有正确对应可能请求会失败下一章的故障排查会讲到这种情况。4.4 验证模型切换多模型配置完成后验证思路很简单分两次运行 Codex第一次使用openai供应商第二次使用deepseek供应商观察启动后是否能正常进入对话并提出一个简单的代码问题比如“用 Python 写一个读取 JSON 文件的函数”。如果输出正常说明当前模型链路是通的。如果报错优先检查环境变量、base_url和wire_api是否匹配。切换模型时可以手动修改config.toml也可以利用 Codex 支持的临时参数。不同版本对临时指定模型的支持程度不同建议先以修改配置文件为准这样理解起来更直接。等你对配置熟悉后再去看更复杂的命令行参数切换方式。5. 手机端远程接入实战5.1 手机 SSH 客户端连接手机端方案以 Termius 为例因为它同时支持 Android 和 iOS界面相对友好。其他同类 SSH 客户端操作也类似。打开 Termius添加一个新的 Host需要填写以下信息IP 地址或域名开发机的局域网 IP例如192.168.1.100。端口SSH 默认 22如果修改过就填实际端口。用户名登录开发机用的用户名。认证方式建议使用密钥认证。手机上可以导入私钥也可以直接使用密码但密码方式安全性弱一些且每次都要重复输入。连接成功后手机终端上看到的应该是一个正常的 shell 提示符此时你可以执行任意命令。5.2 在手机上运行 CodexSSH 连接成功后直接输入codex如果提示找不到命令可能是 codex 安装目录不在非登录 shell 的 PATH 里。可以先用which codex或npm root -g查找位置。找到后可以用完整路径运行例如/usr/local/bin/codex进入 Codex 交互界面后手机终端会显示同样的对话界面。你可以在手机上输入类似下面的请求帮我写一个 Bash 脚本批量重命名当前目录下的所有 .jpg 文件按照创建时间排序并添加序号。Codex 会在开发机上生成代码或直接修改文件。整个过程计算发生在开发机手机只负责传输输入输出所以即使手机性能一般也不会影响 Codex 的工作速度。5.3 进阶手机浏览器网页终端如果你不想单独安装 SSH 客户端或者希望在手机浏览器里快速打开终端可以考虑在开发机上安装一个网页终端服务。常用的开源方案是 ttyd它可以把终端输出到浏览器。在开发机上安装 ttyd 后可以这样启动ttyd -p 7681 codex这条命令的意思是启动一个网页终端端口为 7681进入后自动运行codex。然后手机浏览器访问http://开发机IP:7681注意这里的访问方式是基于局域网。如果你需要跨网络访问不要在公网直接开放 7681 端口更合理的方式是通过 SSH 端口转发或把 ttyd 放在受控的网关后方。比如在开发机上执行ssh -L 7681:127.0.0.1:7681 你的开发机用户名开发机IP这样手机端或电脑端访问本机 7681 端口时数据会经过 SSH 加密隧道转到开发机的 ttyd 服务上不需要把端口直接暴露出去。6. 常见问题与排查清单6.1 local proxy failed 类报错网络讨论中经常见到类似这样的报错信息cc switch local proxy failed while handling codex endpoint /responses.这个报错通常出现在切换模型 Provider 或调整代理配置后。常见原因包括config.toml中指定的wire_api和第三方服务的实际接口不匹配。base_url写错导致 Codex 请求到了不存在的地址。当前模型名在对应服务中不存在。本地代理进程是旧的切换配置后没有重启。排查思路可以按顺序进行先检查config.toml中的模型名是否与官方文档一致。用codex --version确认当前版本不同版本对配置的兼容性有差异。修改配置后完全退出 Codex 进程再重新启动。检查环境变量是否已正确导出例如运行echo $DEEPSEEK_API_KEY看看有没有值。如果依然报错可以把复杂配置临时简化先用最基础的 OpenAI 官方配置跑通确认没有问题后再逐步加入第三方模型配置。6.2 远程计算机拒绝连接手机 SSH 连接开发机时如果提示“远程计算机拒绝连接”或 Connection refused通常原因是开发机上的 SSH 服务未启动或者防火墙拦截了 SSH 端口。排查步骤在开发机上执行sudo systemctl status sshd确认 SSH 服务状态。确认手机填写的 IP 地址是否是开发机当前的实际 IP。如果开发机有多个网卡比如同时使用有线网和无线网可能需要确认手机访问的是哪一个网段的 IP。查看开发机防火墙规则确保没有拦截 22 端口或自定义 SSH 端口。如果手机和开发机不在同一局域网需要确认网络路由是否可达。最简单的做法是先在局域网内测试连接再考虑跨网络方案。6.3 模型切换后对话闪跳有用户反馈切换模型后原对话不停闪跳或者请求没有正确回到当前对话上下文。这个问题通常和 Codex 命令行的会话状态有关也和环境变量轮换有关。建议做法是在切换模型或 API Key 后退出当前 Codex 会话重新启动。不要把多个服务商的 API Key 同时用export导出避免同一个env_key被覆盖。如果使用了自动化脚本管理多个模型确保每个模型运行前重置环境变量而不是一直依赖 shell 里残留的配置。遇到对话界面异常时可以先重启终端再启动 Codex。很多闪跳问题只是客户端渲染异常重新进入后会恢复。7. 最佳实践与安全建议7.1 密钥管理与免密登录手机远程使用 Codex 时如果每次都要输入密码既麻烦也容易出错。建议在开发机和手机之间配置 SSH 密钥认证。在开发机上生成密钥对ssh-keygen -t ed25519 -C mobile-codex然后将公钥添加到开发机的~/.ssh/authorized_keys中或者把私钥导入手机的 SSH 客户端。这样手机连接时就不再需要输入密码同时安全性比单纯密码更高。需要特别注意的是私钥文件一旦泄露等于把开发机访问权限交给了别人。不要在聊天工具里传输私钥不要把私钥截图发到相册更不要上传到不可信的代码仓库。7.2 配置文件与密钥隔离Codex 的config.toml里通常包含模型供应商和 API 地址信息不要把 API Key 直接写在这个文件里。正确做法是使用env_key指向环境变量API Key 通过 shell 配置文件或密钥管理工具注入。开发机上如果存在多个项目建议每个项目或每个任务使用独立的环境变量名称比如export DEEPSEEK_PROJECT_A项目A的Key export DEEPSEEK_PROJECT_B项目B的Key然后不同的 Codex 实例按需加载对应的 Key。7.3 生产环境注意事项如果远程使用 Codex 的场景是个人开发自由度可以很高。但如果要把这套方案用在团队或生产环境需要格外注意不要在多人共享的服务器上明文存放 API Key。谨慎开放任何网页终端端口最好只监听本地并通过 SSH 隧道访问。设置合适的超时和会话限制避免终端会话长期挂起。模型生成的代码必须经过人工审查AI 生成内容不能直接进入生产环境。如果接入第三方模型服务了解该服务的数据存储策略不要在请求中提交敏感密钥或生产机密数据。这些原则不是限制发挥而是保证远程 coding 能长期稳定运行的前提。远程开发的便利性建立在安全边界清晰的基础上边界模糊时便利也会变成风险。8. 后续可以继续探索的方向到这里手机远程使用 Codex 的环境搭建、多模型切换和排障思路已经完整走了一遍。你已经可以做到在电脑上安装并配置 Codex CLI。同时配置 OpenAI 和 DeepSeek 等 OpenAI 兼容模型。通过手机 SSH 客户端远程运行 Codex。通过网页终端满足手机浏览器的即开即用需求。针对常见的连接失败、模型切换报错给出排查思路。下一步可以关注的方向有两个。一个是继续研究 Codex 在自动化脚本中的集成方式比如把 Codex 嵌入 Git Hook 或 CI 流程实现提交信息生成、代码规范检查等能力。另一个是结合你实际使用的云服务器和开发环境制定一套适合自己习惯的远程开发流程把密钥、配置、项目目录都沉淀成一套可复用的模板。远程开发这件事核心不是工具本身而是你是否能把“开发环境”和“操作终端”解耦。理解了这一点手机也好平板也好都能成为你顺手可用的开发入口。