字节笔记本
2026年5月16日
手机端跑 Codex：通过第三方中转站 API 的完整指南
手机端无法直接给 Codex 填第三方中转站 API，真正可行的方式是把手机当作远程控制入口，通过 SSH 连接到 VPS/服务器，在远程环境里配置 Codex CLI 使用第三方中转 API。
架构链路：
手机
↓ SSH / Termius / Blink Shell
远程机器（VPS / Mac / Linux / Codespace）
↓ Codex CLI
第三方中转站 API
↓
模型Codex CLI 配第三方中转站
Codex 的 config.toml 支持自定义 provider 和 base_url。如果中转站兼容 OpenAI 协议，可以用自定义 provider 配置。
配置文件位置：~/.codex/config.toml
model = "gpt-5-codex"
model_provider = "proxy"
model_reasoning_effort = "medium"
[model_providers.proxy]
name = "Proxy"
base_url = "https://你的中转站域名/v1"
env_key = "PROXY_API_KEY"
wire_api = "responses"然后设置环境变量：
export PROXY_API_KEY="你的中转站key"测试运行：
codex "hello"
codex exec "写一个 hello world"中转站必须支持 Responses API
这是最大的坑。Codex 依赖 Responses API，所以中转站不能只兼容：
/v1/chat/completions
还要能兼容：
/v1/responses
如果中转站只支持 Chat Completions，很多聊天工具能跑，但 Codex 可能跑不起来。
先用 curl 测试：
curl https://你的中转站域名/v1/responses \
-H "Authorization: Bearer 你的key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5-codex",
"input": "Say hello"
}'能返回正常结果再接 Codex。
手机端三种方案
方案 A：手机 SSH 到 VPS 跑 Codex（最稳）
手机装 SSH 客户端：Termius、Blink Shell、JuiceSSH。
VPS 上安装 Codex：
npm install -g @openai/codex配置：
mkdir -p ~/.codex编写 ~/.codex/config.toml，手机通过 SSH 登录 VPS 后直接运行 codex。
本质是手机只是终端，Codex 实际运行在 VPS，API 请求也从 VPS 发出去。
方案 B：手机用 VS Code Remote
如果手机上能用浏览器打开 code-server，也可以通过浏览器访问远程机器上的 Codex，适合想看文件、改项目、跑命令的场景。
手机浏览器 → code-server / VS Code Web → 远程机器上的 Codex方案 C：自建 Web 面板（不推荐起步）
Codex 官方有 app-server 方向，支持 JSON-RPC 2.0 和 WebSocket transport（experimental），暴露到公网前需要配置认证。适合做成手机 Web UI，但不建议一开始就搞这个。
排错顺序
按这个顺序排查，不要直接上手机端：
# 1. 看 Codex 是否安装成功
codex --version
# 2. 测试中转站 responses 接口
curl https://你的中转站/v1/responses ...
# 3. 检查 config.toml
cat ~/.codex/config.toml
# 4. 检查环境变量
echo $PROXY_API_KEY
# 5. 跑 Codex
codex "hello"常见报错
| 报错 | 原因 |
|---|---|
| 401 / Unauthorized | key 不对，或 env_key 没读到 |
| 404 / Not Found | 中转站没有 /v1/responses |
| model not found | model 名称不对，或中转站没映射这个模型 |
| 一直请求 api.openai.com | Codex 没读到 provider 配置，或配置了错误的 provider |
注意：某些 Codex CLI 版本会忽略 openai_base_url 或 OPENAI_BASE_URL，仍然请求 api.openai.com。遇到这种情况，优先换成自定义 model_provider，或者升级/降级 Codex CLI。
最小可用配置模板
model = "gpt-5-codex"
model_provider = "proxy"
model_reasoning_effort = "medium"
[model_providers.proxy]
name = "Proxy"
base_url = "https://api.xxx.com/v1"
env_key = "PROXY_API_KEY"
wire_api = "responses"设置环境变量并测试：
export PROXY_API_KEY="sk-xxxx"
codex "用一句话介绍你自己"能跑通之后，手机端只需要 SSH 进去用它。核心不是让 Codex 手机端直接支持第三方 API，而是把手机变成远程控制器。