手机安装 Claude Code + 配置 DeepSeek 完整教程

环境概览

组件	说明
设备	Android 手机 (aarch64)
终端	Termux (最新版，建议 F-Droid 安装)
Node.js	v26.x (通过 Termux pkg 安装)
Claude Code	官方 linux-arm64 二进制 + Android 适配补丁
API 后端	DeepSeek Anthropic 兼容端点
认证方式	API Key (x-api-key 头)

原理: 官方 Claude Code 只提供 glibc 二进制，Android 使用 bionic libc。社区方案通过 patchelf + glibc-runner 让官方二进制在 Android 上运行。

第一步：安装 Termux

从 F-Droid 安装 Termux（Google Play 版本已过时）：

1.下载 F-Droid: https://f-droid.org2.在 F-Droid 中搜索 "Termux" 并安装3.打开 Termux，运行基础更新：

pkg update && pkg upgrade -y

第二步：安装依赖

# 核心依赖pkg install -y nodejs git curl jq patchelf glibc-repo# 启用 glibc 仓库后安装 glibcpkg install -y glibc

验证：

node --version   # 应显示 v26.xnpm --version    # 应显示 11.xgit --version

第三步：安装 Claude Code

使用社区 Android 适配安装脚本：

# 下载安装脚本curl -fsSL https://raw.githubusercontent.com/ferrumclaudepilgrim/claude-code-android/main/install.sh -o install.sh# 运行安装bash install.sh

脚本工作流程：

1.检测 Android/架构环境2.从 npm registry 获取最新版本号3.下载官方 linux-arm64 二进制 (~233 MB)4.校验 SHA256 checksum5.用 patchelf 设置为 glibc 解释器6.通过 smoke test 验证二进制可用7.安装启动器 wrapper 到 $PREFIX/bin/claude

安装约需 5-10 分钟。

验证安装

claude --version# 输出: 2.1.201 (Claude Code)

第四步：获取 DeepSeek API Key

1.访问 https://platform.deepseek.com2.注册/登录账号3.进入 API Keys 页面4.点击 创建 API Key，复制生成的 key（格式：sk-xxxxxxxx...）5.充值（DeepSeek 是预付费，余额为 0 会返回 401）

第五步：配置环境变量

编辑 ~/.bashrc，添加以下内容：

# DeepSeek API for Claude Codeexport ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropicexport ANTHROPIC_API_KEY=sk-你的API-KEY# 关键：清除残留的 OAuth token，否则会覆盖 API Key 认证unset ANTHROPIC_AUTH_TOKEN 2>/dev/null||true

为什么需要 unset ANTHROPIC_AUTH_TOKEN？ Claude Code 认证优先级：ANTHROPIC_AUTH_TOKEN (OAuth) > ANTHROPIC_API_KEY (API Key)。如果有残留的 OAuth token，API Key 会被忽略，导致认证失败返回 401。

第六步：创建 .profile（重要）

Termux 的 bash 可能以 登录 shell 方式启动，此时不会自动加载 .bashrc。创建 ~/.profile 确保环境变量始终生效：

cat >~/.profile <<'EOF'# 为登录 shell 加载 bashrcif[-f ~/.bashrc ];then.~/.bashrcfiEOF

第七步：配置模型

编辑 ~/.claude/settings.json：

{"theme":"dark","autoUpdates":false,"model":"deepseek-v4-pro"}

DeepSeek 支持的模型：deepseek-v4-pro、deepseek-v4-flash

第八步：生效并验证

# 1. 重启 Termux 或手动加载source ~/.bashrc# 2. 确认环境变量echo $ANTHROPIC_BASE_URL   # https://api.deepseek.com/anthropicecho $ANTHROPIC_API_KEY    # sk-xxxxxxxx...# 3. 确认 AUTH_TOKEN 已清除（输出应为空）echo $ANTHROPIC_AUTH_TOKEN# 4. 测试连接claude --print"hello"

如果 claude --print 返回正常回复，说明一切配置成功。

使用方式

# 直接启动交互模式claude# 单次问答（不进交互界面）claude --print"你的问题"# 从 stdin 读取echo "分析这个文件"| claude --print

可选：Claude Code Router (CCR)

如果需要多模型路由（自动切换不同模型处理不同任务），可以安装 CCR：

npm install -g @musistudio/claude-code-router

编辑 ~/.claude-code-router/config.json：

{"LOG":true,"API_TIMEOUT_MS":600000,"Providers":[{"name":"deepseek","api_base_url":"https://api.deepseek.com/anthropic/v1/messages","api_key":"sk-你的API-KEY","models":["deepseek-v4-pro","deepseek-chat","deepseek-reasoner"],"transformer":{"use":["deepseek-to-anthropic"]}}],"Router":{"default":"deepseek,deepseek-v4-pro","background":"deepseek,deepseek-v4-pro","think":"deepseek,deepseek-reasoner","longContext":"deepseek,deepseek-v4-pro"}}

使用方式：

ccr start    # 启动路由器ccr code     # 通过路由器启动 Claude Codeccr stop     # 停止路由器ccr status   # 查看状态

注意: 如果同时配置了直接连接（.bashrc）和 CCR，直接运行 claude 走直接连接，运行 ccr code 走路由器。

常见问题排查

1. 401 Unauthorized

原因	解决
DeepSeek 余额为 0	登录 platform.deepseek.com 充值
`ANTHROPIC_AUTH_TOKEN` 未被清除	`unset ANTHROPIC_AUTH_TOKEN` 后重试
API Key 错误	检查 `~/.bashrc` 中的 key 是否正确
`.bashrc` 未加载	`source ~/.bashrc` 或重启 Termux

2. `error: Cannot read directory "/": EACCES`

Termux 无法访问根目录，这是正常现象，不影响使用。

3. `claude: command not found`

# 确认 PATH 包含安装路径echo $PATH | grep ".local/bin"# 如果没有，在 ~/.bashrc 中添加：export PATH="$PATH:$HOME/.local/bin"

4. 二进制崩溃 / Bad system call

Android 内核缺少 glibc 所需的某些系统调用。安装脚本会自动 blocklist 不兼容的版本并回退到上一个可用版本。

5. DNS 解析失败 (ETIMEOUT)

wrapper 脚本通过 --preload 强制设置 DNS 为 8.8.8.8，一般不需要额外处理。

架构总结

用户终端(Termux)│├──~/.bashrc /~/.profile│├── ANTHROPIC_BASE_URL →DeepSeekAnthropic端点│├── ANTHROPIC_API_KEY   → API Key│└── unset ANTHROPIC_AUTH_TOKEN│├──/data/data/com.termux/files/usr/bin/claude (wrapper)│├──检查版本更新(每天一次)│├──下载/校验/patchelf 新版本│├── smoke test 验证兼容性│└──exec→官方 claude 二进制│└──ClaudeCode二进制├──读取 ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY├──发送Anthropic-format 请求│▼    https://api.deepseek.com/anthropic/v1/messages├──接收Anthropic-format 请求├──转换为DeepSeek内部格式├── deepseek-v4-pro 模型处理└──返回Anthropic-format 响应

参考链接

•Claude Code 官方文档^[1]•DeepSeek API 平台^[2]•Claude Code Android 适配^[3]•Claude Code Router^[4]•上游 Issue: ARM64 Linux 支持^[5]

引用链接

[1] Claude Code 官方文档: https://docs.anthropic.com/en/docs/claude-code
[2] DeepSeek API 平台: https://platform.deepseek.com
[3] Claude Code Android 适配: https://github.com/ferrumclaudepilgrim/claude-code-android
[4] Claude Code Router: https://github.com/musistudio/claude-code-router
[5] 上游 Issue: ARM64 Linux 支持: https://github.com/anthropics/claude-code/issues/50270