如何通过API让手机连接电脑上的Codex？详细教程来了

最近很多小伙伴在问，能不能直接用手机通过API连接到电脑上跑的Codex？毕竟有时候出门在外，手头只有手机，想调试一下代码或者跑个小任务，总不能随身背着笔记本吧。

其实这个需求完全可以实现，而且配置起来并不复杂。今天我就把整个流程梳理一遍，从电脑端到手机端，手把手教大家搞定这个“无线调试”环境。

一、准备工作

首先，我们需要明确一点：所谓的“手机连电脑Codex”，本质上就是让你的手机作为一个客户端，去访问你电脑服务器上暴露出来的API接口。

使用手机上的API调试工具（如Postman）连接电脑端的Codex服务

所以，你需要准备以下两样东西：

1. 电脑端：正在运行Codex，并且能够接收API请求。
2. 手机端：一个能发送HTTP请求的工具（推荐使用Postman的APP版，或者任何支持API调试的客户端）。

二、电脑端配置（关键步骤）

在电脑上查询本机局域网IP地址以便手机连接

很多朋友连不上的根本原因，其实卡在了电脑端的网络配置上。默认情况下，Codex可能只监听了本地的127.0.0.1，这意味着只有电脑自己能访问，手机当然连不上。

你需要修改Codex的启动参数或配置文件，将其监听地址改为0.0.0.0。这代表着允许任何IP地址访问。

修改示例（假设是命令行启动）： 如果原本的启动命令是类似 codex serve --port 8080，你需要确保它允许外网连接。有些工具需要显式指定 --host 0.0.0.0，具体得看你使用的Codex版本或者封装好的启动脚本。

三、解决局域网访问问题

改完监听地址后，接下来就是搞定网络连接。手机和电脑得在同一个网络环境下，或者是电脑有一个公网IP。

方式1：局域网直连（最简单）

1. 确保手机和电脑连的是同一个Wi-Fi。
2. 在电脑上查一下本机的局域网IP（Windows用ipconfig，Mac/Linux用ifconfig），通常是192.168.x.x这样的格式。
3. 拿着这个IP地址，加上Codex的端口，在手机浏览器里试一下能不能访问？比如 http://192.168.1.100:8080。
4. 如果能打开Codex的界面或者返回API数据，说明通道通了。

方式2：内网穿透（常用） 如果你不在家，或者手机用的是流量，那就得用内网穿透工具了（比如cpolar、frp等）。把电脑的Codex端口映射到一个公网域名上，手机就能通过这个域名访问API了。

四、手机端实操

环境通了之后，手机端的操作就很简单了。

以Postman APP为例：

1. 新建一个Request。
2. 在URL栏填入你刚才获取的地址（局域网IP或穿透域名），后面加上API的具体路径，比如 http://192.168.1.100:8080/v1/completions（具体路径看Codex文档）。
3. 选择请求方法（通常是POST）。
4. 在Headers里加上必要的参数，比如 Content-Type: application/json 以及你的鉴权Token（如果Codex开了API Key验证的话）。
5. 在Body里填写你发给Codex的具体指令或代码片段。
6. 点击Send，如果返回了预期的结果，恭喜你，成功了！

五、常见报错与解决方案

1. 连接超时

• 检查电脑防火墙是否拦截了入站连接。Windows Defender或者第三方杀毒软件经常默认阻断外部端口访问，记得在防火墙里放行Codex的端口。

2. 拒绝连接

• 再次确认Codex是不是真的在监听0.0.0.0，而不是只绑定了localhost。

3. 401 Unauthorized

• 这是鉴权问题，检查一下你的API Key是否正确，或者Codex的配置文件里是否允许API访问。

搞定这几步，你就能随时随地用手机操控电脑上的算力了，不管是跑代码还是测试接口，都方便很多。有其他问题欢迎在评论区交流！