跳至主要内容

Termux 環境設定指南

一、安裝 Cascadia Mono NF 字型​

來源：微軟官方 microsoft/cascadia-code v2404.23

# 1. 安裝 unzip（如果還沒有）
pkg install unzip -y

# 2. 下載微軟官方 release zip
curl -fsSL -o ~/cascadia.zip https://github.com/microsoft/cascadia-code/releases/download/v2404.23/CascadiaCode-2404.23.zip

# 3. 解壓
mkdir -p ~/cascadia
unzip ~/cascadia.zip -d ~/cascadia

# 4. 複製字型到 Termux 字型位置
mkdir -p ~/.termux
cp ~/cascadia/ttf/static/CascadiaMonoNF-Regular.ttf ~/.termux/font.ttf

# 5. 套用
termux-reload-settings

# 6. 清理
rm -rf ~/cascadia ~/cascadia.zip

備註​

  • Termux 只認 ~/.termux/font.ttf 這一個路徑，放進去重載即生效。
  • 使用 Cascadia Mono NF（無 ligature）而非 Cascadia Code NF（有 ligature），避免終端排版問題。
  • 如果想要 ligature，步驟 4 改成： 
    cp ~/cascadia/ttf/static/CascadiaCodeNF-Regular.ttf ~/.termux/font.ttf
  • /tmp 在 Termux 可能無法寫入，所有暫存檔用 ~/ 替代。

二、安裝 Claude Code​

官方 native installer（curl | bash）在 Termux 無法使用，因為下載的 Linux ARM64 binary 依賴標準 Linux dynamic linker，與 Termux 的 Android ABI 不相容（e_type 錯誤）。改用 npm 安裝。

安裝步驟​

# 1. 更新 Termux 並安裝依賴
pkg update -y && pkg upgrade -y
pkg install nodejs git -y

# 2. 用 npm 安裝 Claude Code
npm install -g @anthropic-ai/claude-code

# 3. 建立 alias（npm 版不自帶全域 CLI）
alias claude='node /data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/cli.js'

# 4. 寫進 bashrc 持久化
echo "alias claude='node /data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/cli.js'" >> ~/.bashrc

# 5. 測試
claude --version

已知問題：/tmp/claude 權限錯誤​

Claude Code 硬編碼了 /tmp/claude 路徑，在 Termux 上跑較久的指令時可能報 EACCES: permission denied。

判斷方式： 正常使用看看，沒報錯就不用管。

如果遇到了，用 proot 綁定 tmp：

# 安裝 proot
pkg install proot -y

# 用 proot 啟動 claude
proot -b /data/data/com.termux/files/usr/tmp:/tmp claude

也可以把 proot 版本寫成 alias：

alias claude='proot -b /data/data/com.termux/files/usr/tmp:/tmp node /data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/cli.js'

更新 Claude Code​

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