文章总结： 本文档详细介绍了在Android手机上通过Termux安装ClaudeCode并配置DeepSeekAPI的完整步骤。核心方案利用社区适配脚本和patchelf+glibc-runner解决官方二进制与Androidbioniclibc的兼容性问题。关键步骤包括安装Termux与依赖、运行安装脚本、获取DeepSeekAPIKey、配置环境变量并清除OAuthtoken。文档还提供了常见问题排查指南和可选的多模型路由工具CCR的配置方法。 综合评分： 88 文章分类： 安全工具,安全开发,AI安全
手机安装 Claude Code + 配置 DeepSeek 完整教程
luther luther
luther-sec
2026年7月6日 12:41 四川
在小说阅读器读本章
去阅读
环境概览
| 组件 | 说明 | | — | — | | 设备 | 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
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：luther-sec luther luther《手机安装 Claude Code + 配置 DeepSeek 完整教程》
版权声明
本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。
评论