CodeWhale手机安装教程如何在Android/Termux上跑起终端AI编码Agent完整指南【免费下载链接】CodeWhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodeWhaleCodeWhale 是一款用 Rust 编写的开源终端 AI 编码 Agent它能读代码、改文件、跑命令并持续推进任务。本文是一份面向新手的CodeWhale 手机安装教程教你在 Android 手机上的 Termux 环境快速安装并运行这个终端 AI 编码助手全程约 10 分钟。为什么要在手机上装 CodeWhaleCodeWhale 不只属于桌面电脑。出差、通勤、排队时只要有一台 Android 手机你就可以远程处理编码任务修 bug、改测试、跑脚本Agent 自主推进直到完成切换任意模型托管 API 或本地模型都能接/model一键切换权限完全自主Plan 只读模式、审批提示、/undo撤销掌控始终在你手里 Termux 是 Android 上最成熟的 Linux 终端环境是运行 CodeWhale 手机端的官方推荐路径。安装前准备在 Android 上装好 Termux从 F-Droid 或 Termux 官方渠道安装Termux应用建议不要用某些应用市场的旧版镜像打开 Termux授予必要的存储权限升级软件源并安装基础工具pkg update pkg install -y ca-certificates curl tar gzip coreutilsTermux 运行在 Android 的Bionic libc上和普通 Linux 的 glibc 不同——这点很重要它决定了你不能安装 Linux arm64 的压缩包。下面给你三种安装方式按推荐程度排序。方式一源码安装Termux 下最稳妥如果你的网络能访问 crates.io源码安装是当前 Termux 下最可靠的路径pkg install -y rust clang pkg-config make git cargo install codewhale-cli --locked # 安装 codewhale 命令安装过程会在手机后台编译 Rust 项目耗时较长取决于设备性能建议连着电源。方式二官方 Android 预构建包预览版当项目发布包含codewhale-android-arm64.tar.gz的版本时可以直接下载官方预构建包省去编译时间# 1. 从项目发布页下载 codewhale-android-arm64.tar.gz 和校验文件 # 2. 校验完整性 sha256sum -c codewhale-bundles-sha256.txt --ignore-missing # 3. 解压并安装PREFIX$PREFIX 是关键把命令装到 Termux 的 bin 目录 tar xzf codewhale-android-arm64.tar.gz cd codewhale-android-arm64 PREFIX$PREFIX ./install.sh hash -r⚠️两个高频踩坑点❌不要安装codewhale-linux-arm64Android 用 Bionic libcLinux 二进制直接跑不起来⚠️ 不传PREFIX$PREFIX时安装脚本默认装到~/.localTermux 里可能找不到命令如果只是想从源码验证或参与开发仓库地址是git clone https://gitcode.com/GitHub_Trending/de/CodeWhale方式三npm 安装Termux 装好 Node.js 后也可以走 npmnpm install -g codewhalenpm 包装器已能识别 Android arm64 并解析对应的 Android 资源但该路径目前仍为preview 预览状态能否成功取决于你安装的包版本是否发布了匹配的 Android 资源。安装验证一条 doctor 命令看健康状态安装完成后运行这三条命令确认一切就绪codewhale --version codewhale doctor codewhale exec --auto run pwdcodewhale doctor会输出环境自检报告。在 Android 上你会看到沙箱显示为不可用available: false——这是正常的它表示 CodeWhale 自带的 bubblewrap 子进程沙箱没有编译进 Android 构建而不是说系统没有隔离。Termux 本身仍受 Android 应用沙箱独立 UID、SELinux、seccomp保护。配置模型密钥手机端需要注意什么首次运行codewhale会引导你连接模型提供商也可以先保持离线。手机端配置密钥前请了解一个重要差异Termux 构建没有系统钥匙串集成既不支持 Android Keystore也没有桌面的 Secret Service密钥会回退到文件存储写入~/.codewhale/config.toml并镜像到~/.codewhale/secrets/secrets.json这两个文件只有0600权限保护不是加密存储请像对待~/.ssh私钥一样对待它们更安全的临时方案用提供商的环境变量传入密钥codewhale auth set --provider deepseek codewhale auth status # 查看当前密钥来源在手机上实际使用 CodeWhale打开 TUI 后像跟队友说话一样描述任务修复失败的测试并解释改了什么也可以不进入 TUI 直接跑无头任务codewhale exec 修复失败的测试并解释改了什么下面是 CodeWhale 派出多个并行 Agent 侦察工作区的实际效果手机端使用小技巧 不同 Android 终端 App 对全屏 TUI 的渲染能力不同如果你的终端渲染异常改用codewhale exec无头模式✅ 审批系统风险操作提示、allow_shell、--disallowed-tools在 Android 上同样生效已批准命令继承 Termux 的 Android 应用边界但没有CodeWhale 特有的文件系统收窄——你授权给 Termux 的位置含共享存储都可能被命令访问手机端功能支持一览功能状态说明Android 应用沙箱✅ 继承每应用独立 UID 平台级保护CodeWhale 命令沙箱❌ 不可用Android 上无 bubblewrap 后端系统钥匙串❌ 不可用回退到文件存储密钥审批 / 权限门控⚠️ 已实现真机 QA 进行中文件工具⚠️ 已实现真机 QA 进行中自更新⚠️ 已实现会正确选择codewhale-android-arm64资源 目前 Android/Termux 支持整体为preview 预览阶段真机 QA 完成后会转为正式支持。常见问题 FAQQ能安装codewhale-linux-arm64到 Termux 吗不能。Android 是 Bionic libc与 Linux glibc/musl 不同Linux 二进制无法运行请使用 Android 专用包或源码编译。Q手机上编译很慢正常吗正常。Rust 源码编译在手机上可能需要 10 分钟以上建议插电进行如果发布过 Android 预构建包优先用方式二。Q密钥存在手机上是明文安全吗文件存储只有权限位保护、未加密。单机单用户的 Termux 场景下与~/.ssh私钥同级介意的话优先用环境变量传入密钥。Q以后怎么更新运行codewhale update它在 Android 上会自动请求codewhale-android-arm64资源并跳过仅 Linux 适用的 glibc 预检。延伸阅读平台细节与已知限制docs/TERMUX.md全平台安装路径与校验和说明docs/INSTALL.md中文总览README.zh-CN.md现在打开你的 Termux10 分钟后就能在口袋里跑起一个能自己干活的 AI 编码 Agent 了 【免费下载链接】CodeWhaleOpen-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.项目地址: https://gitcode.com/GitHub_Trending/de/CodeWhale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考