在 Android Termux 设备上安装 Claude Code 和 Codex

在 Android 手机或平板的 Termux 环境中部署 Claude Code 与 Codex，可将设备用作轻量级 AI 编程终端，适合修改脚本、查看日志、维护博客及处理仓库内的零散任务。本文梳理两者在 Termux 下的安装、认证与适用边界。

为何依赖社区分发版本

官方 CLI 的分发策略并不总能直接适配 Termux。当前两个工具均通过社区维护的项目以 npm scoped package 形式重新分发，以适配 Android + Node.js 环境：

Codex：DioNanos/codex-termux，发布包为 @mmmbuto/codex-cli-termux。该版本针对 Termux 做了适配，其中较关键的一处改动是在登录回调时改用 termux-open-url 调起系统浏览器，以契合 Android 的交互方式。
Claude Code：CometixSpace/claude-code，发布包为 @cometix/claude-code。该项目将 Claude Code 恢复为可在 Node.js 环境运行的版本，用以规避官方新版仅分发原生二进制、在部分 Node.js 环境无法运行的问题。

需要说明的是，上述两者均非官方 npm 包，而是第三方维护的重分发版本。在生产或涉及敏感凭据的场景中使用前，应自行评估来源可信度与更新维护状况。

适用环境

Codex Termux 仓库明确其面向 Android ARM64，要求 Android 7.0 / API 24 及以上、Termux 与 Node.js 18 及以上；近年的多数 Android 手机与平板均满足该条件。Claude Code 恢复版同样依赖 Node.js 运行时，在 Termux 中安装 nodejs-lts 后即可运行。

1. 准备 Termux 环境

首次进入 Termux，先更新系统包：

1
pkg update && pkg upgrade -y

安装 Node.js、Git 及常用搜索工具：

1
pkg install -y nodejs-lts git ripgrep

确认版本：

1
node -v
2
npm -v
3
git --version

授予存储权限：

1
termux-setup-storage

2. 安装 Codex Termux

1
npm install -g @mmmbuto/codex-cli-termux@latest

安装后验证并启动：

1
codex --version
2
codex

首次使用通常需要登录，按提示完成即可。

配置 Codex 认证（OpenAI 兼容 API）

若使用 OpenAI 兼容的 API 服务（中转 API 或自建服务），可通过配置文件直接认证，无需浏览器登录。

创建认证文件 ~/.codex/auth.json：

1
mkdir -p ~/.codex
2
cat > ~/.codex/auth.json << 'EOF'
3
{
4
  "OPENAI_API_KEY": "sk-xxxx"
5
}
6
EOF

创建或编辑配置文件 ~/.codex/config.toml：

1
cat > ~/.codex/config.toml << 'EOF'
2
model_provider = "OpenAI"
3
model = "gpt-5.5"
4
review_model = "gpt-5.5"
5
model_reasoning_effort = "xhigh"
6
disable_response_storage = true
7
network_access = "enabled"
8
model_context_window = 1000000
9
model_auto_compact_token_limit = 900000
10

11
[model_providers.OpenAI]
12
name = "OpenAI"
13
base_url = "https://your-api-endpoint.com"
14
wire_api = "responses"
15
requires_openai_auth = true
16
EOF

关键字段：

OPENAI_API_KEY：实际 API Key
base_url：API 端点地址
model：依所用服务支持的模型名称调整
model_context_window：上下文窗口大小（此处为 100 万 tokens）
model_auto_compact_token_limit：自动压缩阈值（90 万 tokens）

3. 安装 Claude Code

1
npm install -g @cometix/claude-code@latest

验证并启动：

1
claude --version
2
claude

配置 Claude Code 认证

Claude Code 通过环境变量配置 API 认证，适用于 Anthropic API 或兼容服务。编辑 ~/.bashrc 写入：

1
cat >> ~/.bashrc << 'EOF'
2

3
# Claude Code API 配置
4
export ANTHROPIC_AUTH_TOKEN=sk-ant-xxxxx
5
export ANTHROPIC_BASE_URL=https://your-api-endpoint.com
6
EOF

使其生效并验证：

1
source ~/.bashrc
2
echo $ANTHROPIC_AUTH_TOKEN
3
echo $ANTHROPIC_BASE_URL

字段说明：

ANTHROPIC_AUTH_TOKEN：Anthropic API Key 或兼容服务的 Token
ANTHROPIC_BASE_URL：API 端点地址（使用官方 API 时可省略）

配置完成后重启 Claude Code 即可直接使用，无需浏览器登录。

4. 适用边界

Termux 上的 AI 编程终端胜在便携，但受限于移动设备的算力与续航，宜用于轻量任务，重负载工作仍应交给桌面或服务器环境。

适宜场景：

配置文件与脚本的快速修改
个人博客与文档维护
Git 仓库的日常操作
代码审查与小规模重构
学习与新技术实验

不宜场景：

大型项目的完整编译
高计算资源消耗的任务
长时间持续开发