Colorful Geek

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

把 Claude Code 和 Codex 装进 Termux ，手机、平板、备用机就可以变成一个轻量 AI 编程终端：改脚本、看日志、维护博客、处理仓库里的小任务都很方便。

本文使用以下两个社区项目来实现 codex 和claude code 的安装：

适用环境

Codex Termux 仓库说明里写明当前面向 Android ARM64，并要求 Android 7.0 / API 24 以上、Termux、Node.js 18 以上。大多数近几年的 Android 手机和平板都满足这个条件。

Claude Code 这个仓库的定位是把 Claude Code 恢复成可在 Node.js 环境中运行的版本，并通过 npm scoped package 分发。Termux 里安装 nodejs-lts 后即可尝试。

1. 准备 Termux 环境

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

Terminal window
pkg update && pkg upgrade -y

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

Terminal window
pkg install -y nodejs-lts git ripgrep

检查版本：

Terminal window
node -v
npm -v
git --version

授权存储权限：

Terminal window
termux-setup-storage

2. 安装 Codex Termux

Codex Termux 的安装命令：

Terminal window
npm install -g @mmmbuto/codex-cli-termux@latest

安装后检查：

Terminal window
codex --version

启动：

Terminal window
codex

首次使用通常需要登录，按照提示正常登录即可。这个 Termux 版本相对官方 CLI 的关键改动之一，是在登录回调时使用 termux-open-url 打开系统浏览器，适配 Android + Termux 的使用方式。

配置 Codex 认证（使用 OpenAI 兼容 API）

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

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

Terminal window
mkdir -p ~/.codex
cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "sk-xxxx"
}
EOF

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

Terminal window
cat > ~/.codex/config.toml << 'EOF'
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000


[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://your-api-endpoint.com"
wire_api = "responses"
requires_openai_auth = true
EOF

配置说明：

  • OPENAI_API_KEY：替换为你的实际 API Key
  • base_url：替换为你的 API 端点地址
  • model：根据你的 API 支持的模型名称调整
  • model_context_window：上下文窗口大小（100 万 tokens）
  • model_auto_compact_token_limit：自动压缩阈值（90 万 tokens）

3. 安装 Claude Code

安装 Claude Code 恢复版：

Terminal window
npm install -g @cometix/claude-code@latest

检查：

Terminal window
claude --version

启动：

Terminal window
claude

需要注意，这个包不是 Anthropic 官方 npm 包，而是哈雷大佬恢复并重新发布的 Node.js 版本。它的价值是绕过官方新版只分发原生二进制后在某些 Node.js 环境不可用的问题。

配置 Claude Code 认证

Claude Code 支持通过环境变量配置 API 认证，适合使用 Anthropic API 或兼容服务。

编辑 ~/.bashrc 添加环境变量：

Terminal window
cat >> ~/.bashrc << 'EOF'


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

使配置生效：

Terminal window
source ~/.bashrc

验证环境变量：

Terminal window
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

配置说明：

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

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

4. 使用建议

如果只是手机上临时改代码、维护博客、处理脚本，Termux + Claude Code/Codex 已经够用；如果要长时间编译大型项目，还是建议把 Android 设备当远程终端，连接到真正的 Linux 服务器或桌面开发机。

推荐使用场景：

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

不推荐场景：

  • 大型项目的完整编译
  • 需要大量计算资源的任务
  • 长时间持续开发（建议使用桌面环境）