在 Termux 上一键部署 Codex CLI
背景与原理
简单说，Codex CLI 是 OpenAI 的命令行编程助手，可以在终端里让它读写代码；Termux 是 Android 上的终端模拟器，能跑 Linux 工具链。理论上把 Codex 的二进制丢进 Termux 就能用，但实际上会踩三个坑：
- DNS — Termux 里的
/etc/resolv.conf是特殊文件，直接改会被系统覆盖，需要做修补 - 沙箱 — Codex 默认沙箱依赖 bubblewrap，Android 上根本没有，只能加
--sandbox danger-full-access绕过 - SSL — 证书路径跟标准 Linux 不一样，要指向 Termux 自己的证书目录
这三个问题不解决，装完大概率跑不起来，而且报错还不直观。所以我写了个一键安装脚本 codex-termux.sh，把这些环境问题全部自动修补掉。
项目地址：https://gitee.com/knight3fax/codex-termux
脚本还做了几件省事的事：
- 已有二进制就跳过下载，重复执行不会浪费时间
- 多源下载 — GitHub 直连不行会自动切镜像源
- 支持自定义 API — 装完配合换 API 脚本或环境变量就能指向任意兼容接口
部署
环境要求
- Termux（Android aarch64）
- 已安装
curl、wget、python3、nodejs、binutils
缺的话先在 Termux 里：
1 | pkg install curl wget python3 nodejs binutils |
安装
1 | bash codex-termux.sh install |
配置 API
装完之后，可以用你自己的换 API 脚本：
1 | curl -s https://你的地址/setup-codex.sh | bash -s -- --url https://你的api地址 --key sk-你的key |
或者直接设环境变量：
1 | export OPENAI_BASE_URL=https://你的api地址 |
装完的文件
| 路径 | 说明 |
|---|---|
~/.local/lib/codex/codex | Codex 二进制（已修补 DNS） |
~/.local/bin/codex | 启动 wrapper 脚本 |
~/.config/codex/resolv.conf | DNS 配置 |
~/.codex/config.toml | Codex 配置（由换 API 脚本生成） |
这里容易踩坑：换 API 的脚本地址一定要是 Termux 里访问得到的 HTTPS 地址，curl | bash 这种形式如果脚本里有错误提示会比较绕，可以先下载下来看一遍再跑。
总结
如果你想在 Android 手机上跑 Codex CLI，这个脚本能省掉最麻烦的环境修补部分。原始方案来自 PeroSar/claude-codex-termux，我只是把流程整理成了可重复执行的一键脚本。
- 标题: 在 Termux 上一键部署 Codex CLI
- 作者: 番星
- 创建于 : 2026-08-22 10:25:00
- 更新于 : 2026-08-25 16:45:08
- 链接: https://xingbox.me/codex-termux-installer/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。