手机安装 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
版权声明
本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。
评论