AI 工具 on 风轻云淡

Termux 安装 Hermes Agent 完整指南

pzb678@criptext.com (彭宅波) — Wed, 26 Aug 2026 10:40:00 +0800

Hermes Agent 是 Nous Research 开源的 AI Agent。与普通聊天 CLI 不同，它强调工具调用、长期记忆、技能学习、MCP、后台任务和多种模型提供商。

Hermes 官方目前把 Android/Termux 列为 Tier 2 平台，也就是持续维护但属于 best-effort 支持。官方已经提供专门的 Termux 安装路径，因此在 Android 上应优先采用官方 Termux 安装方式，而不是直接套用桌面 Linux 的依赖方案。

一、Termux 基础环境

先更新软件包：

1

pkg update && pkg upgrade -y

官方手动路径使用以下依赖：

1

pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

检查：

1
2
3
4
5


python --version
node --version
git --version
rg --version
ffmpeg -version

二、推荐：官方一键安装

Hermes 官方目前提供 Termux 感知的安装器：

1

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装器会检测 Termux，并使用 Android 对应的安装流程，包括 pkg、Python venv 和 Termux 专用依赖。

安装结束后重新加载 shell：

1

source ~/.bashrc

然后检查：

1
2


hermes version
hermes doctor

最后启动：

1

hermes

三、需要完全控制时：手动安装

如果一键安装失败，官方文档给出了完全显式的 Termux 流程。

首先获取源码：

1
2


git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

创建虚拟环境：

1
2


python -m venv venv
source venv/bin/activate

设置 Android API Level：

1

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"

升级 Python 构建工具：

1

python -m pip install --upgrade pip setuptools wheel

然后安装官方测试的 Termux extra：

1

python -m pip install -e '.[termux]' -c constraints-termux.txt

如果只需要最小核心：

1

python -m pip install -e '.' -c constraints-termux.txt

四、让 `hermes` 永久可用

手动安装完成后：

1

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

这样 $PREFIX/bin 中就会存在 Hermes 命令，不需要每次新开 Termux 都重新激活 venv。

验证：

1
2


hermes version
hermes doctor

五、为什么必须设置 `ANDROID_API_LEVEL`

Hermes 的部分 Python 依赖会使用 Rust/maturin 构建。在 Android 上，构建系统需要知道目标 Android API Level。

官方 Termux 文档特别指出，像 jiter 这样的依赖可能需要：

1

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"

如果出现 maturin、Rust native extension 或 ANDROID_API_LEVEL 相关错误，首先确认：

1
2


echo "$ANDROID_API_LEVEL"
getprop ro.build.version.sdk

然后重新执行 pip 安装。

六、首次配置模型

Hermes 安装完成后，可以直接运行：

1

hermes model

也可以运行完整设置向导：

1

hermes setup

如果使用官方 Nous Portal，也可以按当前版本的向导完成 OAuth 配置。

如果使用自己的模型 API，可以按照 Hermes 当前支持的 provider 配置 API Key 和模型。

七、检查 Hermes 当前状态

推荐安装完成后固定执行：

1

hermes doctor

它能够帮助检查 Python 环境、依赖、配置和工具状态。

日常更新：

1

hermes update

查看帮助：

1
2
3


hermes --help
hermes model --help
hermes tools --help

八、Termux 下最重要的限制

Android 版本并不是桌面/服务器完整功能的等价物。官方当前文档明确指出：

`.[all]` 不属于 Android 推荐路径

Android 当前应使用：

1

python -m pip install -e '.[termux]' -c constraints-termux.txt

而不是强行安装：

1

python -m pip install -e '.[all]'

Voice 依赖存在 Android 限制

voice extra 会涉及 faster-whisper 和 ctranslate2，而 ctranslate2 当前没有适用于 Android 的标准 wheel，因此不能把桌面语音依赖方案原样搬到 Termux。

Docker 不可用

Termux 内不能把 Docker 作为 Hermes 的标准终端隔离后端。

浏览器自动安装被跳过

官方 Termux 安装流程会跳过未经验证的浏览器/Playwright 引导。因此浏览器相关能力应视为实验功能，而不是 Android 上的默认稳定功能。

后台任务可能被 Android 挂起

即使 Hermes 本身配置正确，Android 的后台进程管理也可能暂停 Termux。Telegram gateway 等长期后台服务因此属于 best-effort，而不是服务器上的标准托管服务。

九、Node.js 与浏览器工具

官方 Termux 核心路径会准备 Node.js，但不会强制执行完整浏览器 bootstrap。

如果之后需要实验 Node/browser 工具：

1
2


pkg install nodejs-lts
npm install

在 Termux 中，相关工具会搜索 Termux 的 bin 目录，因此通常不需要为了 npx 再额外修改 PATH。

十、Hermes 配置文件

根据当前安装方式，Hermes 的用户配置位于 ~/.hermes 体系中。API Key 可以通过 Hermes 的配置命令或 .env 配置。

检查目录：

1

ls -la ~/.hermes

不要公开：

1
2
3
4


~/.hermes/.env
API Key
OAuth Token
个人聊天数据

十一、Termux 安装失败时的标准排查顺序

1. Python 环境

1
2


python --version
which python

2. Android API Level

1
2


echo "$ANDROID_API_LEVEL"
getprop ro.build.version.sdk

3. 编译工具链

1

pkg install -y clang rust make pkg-config libffi openssl

4. Node 和 ripgrep

1

pkg install -y nodejs ripgrep

5. pip 安装

1
2
3
4


source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e '.[termux]' -c constraints-termux.txt

6. Hermes 自检

1
2


hermes version
hermes doctor

如果仍然失败，保留完整错误输出，不要只截取最后一行。Android native package 的失败原因通常位于前面的编译日志中。

十二、与 Claude Code、Codex 共存

Hermes 可以和其他终端 AI 编程代理同时存在：

1
2
3


claude --version
codex --version
hermes version

它们的定位并不完全相同：

工具	主要定位
Claude Code	Claude 生态的终端编码 Agent
Codex CLI	OpenAI 的终端编码 Agent
Hermes Agent	更强调 Agent 工具、记忆、技能、MCP 和多 Provider 的通用 Agent

在 Termux 手机环境中，可以根据任务选择不同工具，而不需要删除其他 CLI。

十三、推荐的最终安装流程

如果是全新 Termux，建议按以下顺序：

1
2
3
4
5
6
7
8


pkg update && pkg upgrade -y
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes version
hermes doctor
hermes model
hermes

如果一键安装出现 Android 依赖问题，再切换到官方手动路径，而不是盲目安装桌面版 .[all]。

十四、结语

Hermes 是目前三款工具中对 Termux/Android 文档支持最明确的一款：官方已经提供专门的 Termux 安装器和手动安装说明，但 Android 仍然属于 Tier 2。

因此最稳妥的原则是：使用官方 Termux installer；失败时使用 .[termux]；设置 ANDROID_API_LEVEL；最后用 hermes doctor 验证。

这样可以避免把桌面 Linux 的依赖方案直接搬到 Android，尤其可以绕开目前 Android 上不兼容的 voice、Docker 和部分浏览器依赖。

Termux 安装 OpenAI Codex CLI 完整指南

pzb678@criptext.com (彭宅波) — Wed, 26 Aug 2026 10:35:00 +0800

OpenAI Codex CLI 是运行在终端中的编码代理。官方当前仓库提供 npm 安装方式，也提供 Linux/macOS 的独立安装器和预编译版本。对于 Android Termux，最重要的区别是：官方提供的是 Linux、macOS、Windows 等平台的安装路径，Android/Termux 并不是独立的一等官方平台，因此在 Termux 上应优先使用 npm 路径并根据实际 CPU 架构验证二进制是否可运行。

一、准备 Termux

更新系统：

1

pkg update && pkg upgrade -y

安装基础环境：

1

pkg install -y git nodejs npm curl ripgrep

确认 Node.js 和 npm：

1
2
3


node --version
npm --version
uname -m

如果输出 aarch64，说明手机使用 ARM64，这是现代 Android 手机最常见的架构。

二、安装 Codex CLI

官方仓库当前提供 npm 安装方式：

1

npm install -g @openai/codex

然后检查：

1
2


which codex
codex --version

如果 npm 安装成功但 codex 不在 PATH 中，检查：

1
2


npm config get prefix
printf '%s\n' "$PATH"

不要使用 sudo npm install -g。Termux 的软件和 npm 全局包应保持在 Termux 自己的用户空间。

三、首次运行

进入项目目录：

1
2


cd ~/src/your-project
codex

Codex 首次运行时可以选择 Sign in with ChatGPT。官方说明支持使用 ChatGPT 账户，也可以通过 API Key 进行额外配置。

如果选择 ChatGPT 登录，按照终端显示的认证流程完成授权即可。

四、先验证 Codex 是否真正可用

安装成功不等于 Android 上的运行时一定兼容。建议执行：

1
2


codex --version
codex

然后在项目中进行低风险测试，例如：

1

请只分析当前项目结构，不要修改任何文件。

如果能够正常进入 Codex 会话并读取项目，说明当前 Termux 环境基本可用。

五、为什么不能直接照搬 Linux ARM64 二进制

官方 Releases 中存在 Linux ARM64 构建，例如 aarch64-unknown-linux-musl。但 Android 使用的是 Android/Bionic 用户空间，而普通 Linux 使用 glibc 或 musl 等 Linux 用户空间。

因此：

1

Android aarch64 ≠ Linux aarch64

即使 CPU 都是 ARM64，也不能仅凭 uname -m 判断一个 Linux ELF 就能直接在 Android 上运行。

在 Termux 中更推荐先使用：

1

npm install -g @openai/codex

然后让 npm 包提供的安装逻辑处理当前平台。如果最终下载到的 native binary 与 Android 不兼容，再根据具体报错判断是 ABI、动态链接器、系统调用还是权限问题。

六、常见架构与动态链接问题

查看系统：

1
2
3


uname -a
uname -m
getprop ro.product.cpu.abi

查看 Codex 文件：

1
2


which codex
file "$(which codex)"

如果命令实际上是一个脚本或 Node wrapper，可以继续定位 npm 全局包：

1

npm root -g

如果 native executable 报类似 No such file or directory、Exec format error 或动态库错误，不要反复执行安装命令，应先确定实际下载的 binary 架构和 ABI。

七、Termux 中的项目目录建议

八、API Key 与环境变量

如果不使用 ChatGPT 登录，而是使用 API Key，应按照 OpenAI 当前 Codex 文档配置认证。

检查是否存在旧环境变量：

1

env | grep -E '^(OPENAI_|CODEX_)'

尤其不要把 API Key 直接写入 Git 仓库，也不要把包含密钥的 .bashrc 发布到博客。

如果以前使用过其他 OpenAI 兼容网关，建议先检查并清理旧变量，避免 Codex 实际连接到错误的 endpoint。

九、常用工作流

进入项目：

1
2


cd ~/src/project
codex

典型任务可以直接描述：

1

分析这个项目的构建错误，先不要修改文件。

1

检查 GitHub Actions 最近一次失败的原因，并给出最小修复方案。

1

修复测试失败的问题，修改后运行相关测试。

对于涉及删除、覆盖或批量修改的任务，应先让 Codex 给出计划，再执行修改。

十、与 Claude Code 共存

Claude Code 和 Codex 都是终端 AI 编程代理，可以同时安装：

1
2


npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex

检查：

1
2


claude --version
codex --version

二者使用独立命令，不需要二选一。

建议：

1
2


claude → Claude Code 工作流
codex → OpenAI Codex 工作流

不要把两个工具的认证环境变量混在一起管理。

十一、故障排查顺序

1. npm 安装失败

1
2
3
4
5
6


pkg update
pkg upgrade -y
pkg install -y nodejs npm
node --version
npm --version
npm install -g @openai/codex

2. `codex: command not found`

1
2
3


which codex
npm config get prefix
printf '%s\n' "$PATH"

3. `Exec format error`

1
2


uname -m
file "$(which codex)"

重点检查 Android 与 Linux binary 的兼容性。

4. 登录失败

先确认网络正常，然后直接运行：

1

codex

按终端提示重新进行 ChatGPT 登录。若使用 API Key，则检查相关认证环境变量是否正确。

十二、安全注意事项

Codex 能够执行代码、修改文件并运行命令。不要在包含重要私钥、密码或个人数据的目录中直接运行高权限自动化任务。

尤其避免把下面内容提交到 Git：

1
2
3
4
5
6


.env
API Key
OAuth Token
SSH 私钥
Cloudflare Token
数据库密码

十三、结语

在 Termux 上安装 Codex 的最简路径是：

1
2
3
4


pkg update && pkg upgrade -y
pkg install -y nodejs npm git
npm install -g @openai/codex
codex

但 Android 与普通 Linux 的 ABI 不同，因此真正需要关注的是 native binary 的兼容性，而不是单纯的 npm 安装是否完成。对于 Termux，建议以 npm 安装结果和实际运行测试为准，并保留 uname -m、file 和完整错误信息，便于定位 Android 特有问题。

Termux 安装 Claude Code 完整指南

pzb678@criptext.com (彭宅波) — Wed, 26 Aug 2026 10:30:00 +0800

Claude Code 是 Anthropic 的终端 AI 编程代理。官方当前文档要求 Node.js 18+，标准安装方式是通过 npm 全局安装 @anthropic-ai/claude-code。需要注意的是，Anthropic 官方支持列表主要面向 macOS、Linux 和 Windows/WSL，并没有把 Android/Termux 列为正式支持平台。因此，本文的 Termux 部分属于实际可用的移动端运行方案，遇到 Android 特有问题时应以实际版本为准。

一、准备 Termux

建议使用来自 F-Droid 或 GitHub Releases 的新版 Termux，而不是长期停留在旧版 Google Play 构建。

先更新软件包：

1

pkg update && pkg upgrade -y

安装 Claude Code 常用依赖：

1

pkg install -y git nodejs npm curl wget ripgrep

检查版本：

1
2
3


node --version
npm --version
git --version

Node.js 应至少满足 Claude Code 官方要求的 18+。

二、安装 Claude Code

官方标准 npm 安装命令：

1

npm install -g @anthropic-ai/claude-code

不要使用 sudo npm install -g。Termux 本身不需要 sudo，直接使用 Termux 的 $PREFIX 环境即可。

安装完成后检查：

1
2
3


which claude
claude --version
claude doctor

如果 claude 找不到，先检查 npm 全局 bin：

1
2
3


npm prefix -g
npm bin -g 2>/dev/null || true
printf '%s\n' "$PATH"

Termux 的 npm 全局命令通常应该落在 $PREFIX/bin 可访问的位置。如果 PATH 被自行修改过，优先修正 PATH，而不是重复安装。

三、首次启动与认证

进入代码项目：

1
2


cd ~/your-project
claude

首次启动时按照 Claude Code 的认证流程完成登录。官方支持 Anthropic Console，以及符合条件的 Claude Pro/Max 账户；企业环境还可以使用 Bedrock 或 Vertex AI。

完成认证后，可以先执行：

1

/init

让 Claude Code 分析当前项目并生成项目级 CLAUDE.md。项目级指令适合记录架构、构建命令、测试命令和代码规范。

四、Termux 中的推荐工作方式

建议把代码放在 Termux 的 Linux 文件系统中，例如：

1
2
3
4
5


mkdir -p ~/src
cd ~/src
git clone <你的仓库>
cd <项目目录>
claude

大量项目文件不建议直接放在 /sdcard 或 /storage/emulated/0 后进行高频编译，因为 Android 共享存储的权限和文件系统语义可能影响 Git、Node、构建工具和文件监听。

如果需要访问手机共享存储，可执行：

1

termux-setup-storage

但源码、虚拟环境和 node_modules 更推荐放在 ~ 下。

五、API 环境变量：不要把配置写乱

Claude Code 支持通过环境变量配置 API/Gateway。最容易出现的问题，是在 .bashrc 中重复定义 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_BASE_URL，导致后面的值覆盖前面的值。

检查当前环境：

1

env | grep -E '^ANTHROPIC_|^CLAUDE_'

如果只使用官方 Anthropic 服务，应尽量保持环境简单，不要同时设置多个互相冲突的认证变量。

如果使用兼容 Anthropic API 的网关，应明确设置对应的 Base URL 和认证变量。例如：

1
2


export ANTHROPIC_BASE_URL="https://example.com"
export ANTHROPIC_AUTH_TOKEN="你的令牌"

真实密钥不要写进 Git 仓库、博客文章或截图。

六、常用命令

1
2
3
4
5
6
7


claude
claude "检查这个项目的构建错误"
claude -p "总结当前项目结构"
claude --continue
claude --resume <session-id>
claude update
claude doctor

自动化脚本可以使用 -p 非交互模式，并结合 --output-format json 获取结构化输出。

七、Termux 常见问题

1. `node: command not found`

1
2
3


pkg install -y nodejs
which node
node --version

2. `claude: command not found`

检查：

1
2
3


which claude
npm prefix -g
printf '%s\n' "$PATH"

确认 npm 全局 bin 位于 PATH 中。

3. npm 权限错误

不要在 Termux 中使用 sudo。检查 npm prefix 是否指向 Termux 环境：

1

npm config get prefix

正常情况下应使用 Termux 的 $PREFIX 路径。

4. API 连接异常

先确认环境变量：

1

env | grep '^ANTHROPIC_'

再检查网络和 Base URL。尤其要排查 .bashrc、.profile、.zshrc 中是否存在重复配置。

八、安全建议

Claude Code 能够读取项目、执行命令和修改文件，因此不要在不可信目录中随意授予高权限操作。特别是 --dangerously-skip-permissions 应谨慎使用。

同时建议：

API Key 只放在本机环境变量或安全凭据存储中。
不要把 .env、Token 和 Cookie 提交到 Git。
对陌生仓库先阅读 README、构建脚本和权限相关配置。
在手机上尤其注意 Termux 进程和文件权限边界。

九、结语

在 Termux 中运行 Claude Code 的核心链路很简单：Termux → Node.js 18+ → npm → Claude Code → 登录/API。真正容易出问题的并不是安装命令，而是 Android 平台兼容性、PATH、npm 全局目录以及重复的 API 环境变量。

本文按 2026 年 8 月的官方 Claude Code 安装方式整理；由于 Termux 并非 Anthropic 官方重点支持平台，后续版本升级时应优先检查官方系统要求和 claude doctor。

AI 工具 on 风轻云淡

Termux 安装 Hermes Agent 完整指南

一、Termux 基础环境

二、推荐：官方一键安装

三、需要完全控制时：手动安装

四、让 hermes 永久可用

五、为什么必须设置 ANDROID_API_LEVEL

六、首次配置模型

七、检查 Hermes 当前状态

八、Termux 下最重要的限制

.[all] 不属于 Android 推荐路径

Voice 依赖存在 Android 限制

Docker 不可用

浏览器自动安装被跳过

后台任务可能被 Android 挂起

九、Node.js 与浏览器工具

十、Hermes 配置文件

十一、Termux 安装失败时的标准排查顺序

1. Python 环境

2. Android API Level

3. 编译工具链

4. Node 和 ripgrep

5. pip 安装

6. Hermes 自检

十二、与 Claude Code、Codex 共存

十三、推荐的最终安装流程

十四、结语

Termux 安装 OpenAI Codex CLI 完整指南

一、准备 Termux

二、安装 Codex CLI

三、首次运行

四、先验证 Codex 是否真正可用

五、为什么不能直接照搬 Linux ARM64 二进制

六、常见架构与动态链接问题

七、Termux 中的项目目录建议

八、API Key 与环境变量

九、常用工作流

十、与 Claude Code 共存

十一、故障排查顺序

1. npm 安装失败

2. codex: command not found

3. Exec format error

4. 登录失败

十二、安全注意事项

十三、结语

Termux 安装 Claude Code 完整指南

一、准备 Termux

二、安装 Claude Code

三、首次启动与认证

四、Termux 中的推荐工作方式

五、API 环境变量：不要把配置写乱

六、常用命令

七、Termux 常见问题

1. node: command not found

2. claude: command not found

3. npm 权限错误

4. API 连接异常

八、安全建议

九、结语

四、让 `hermes` 永久可用

五、为什么必须设置 `ANDROID_API_LEVEL`

`.[all]` 不属于 Android 推荐路径

2. `codex: command not found`

3. `Exec format error`

1. `node: command not found`

2. `claude: command not found`