1. Windows 上让 Cursor Agent 真正会写 Android 代码Android CLI 是 Google 在 2026 年推出的终端工具链命令名就叫android它把 SDK 安装、项目脚手架、设备部署、官方文档检索这些动作统一成 Agent 能直接调用的标准命令。Android Skills 则是配套的指令包每个 Skill 是一个带SKILL.md的目录Cursor 启动时扫描到它就能在合适的对话里自动加载领域知识。这套组合最适合谁答案是在 Windows 上用 Cursor Agent 写 Android、又不想每次手动敲sdkmanager和adb的开发者。我自己的痛点是让 Cursor 帮忙装个 SDK它会猜路径让它查 Navigation 3 的写法它凭训练数据编。Android CLI 把这两件事都变成可执行命令Skills 则把「LLM 不擅长的领域知识」按需注入。官方博客给出的数字是 Agent 工作流效率提升约 3 倍主要来自减少 Token 消耗和试错次数。这篇按 Windows 从零搭建的顺序写先装 CLI再初始化 Skills然后给出可复制的配置片段最后用 Cursor Agent 实际跑一遍构建、安装、抓日志并说明怎么用 TaoToken 统一管理模型调用的 Key 和 API 通道。全程命令可直接复制。2. TaoToken 前置统一 Key 与 API 通道管理在动手装 CLI 之前先把模型调用的通道理清楚。Cursor Agent 背后要调模型如果你同时用 Claude Code、Codex、Cline 这些工具每个都配一遍 Key 和 Base URL 会很乱。TaoToken 的作用就是把这些调用收敛到一个入口一个 Key、一个 API 地址模型 ID 按需切换。它的 API 地址是https://taotoken.net/api控制台在https://taotoken.net/consoleKey 在https://taotoken.net/api-keys生成。文档入口在https://taotoken.net/doc。官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。为什么 Android CLI 场景要提这个因为 Cursor Agent 在执行android docs search、分析 R8 规则、迁移 Compose 这些任务时会频繁调用模型。如果每个工具各配一套凭证排查问题时你分不清是 CLI 报错还是 Key 失效。统一通道后401 这类错误只可能来自一个地方排障路径短很多。具体做法是在 Cursor 的模型设置里把自定义 OpenAI 兼容端点指向 TaoToken 的 API 地址填入在 api-keys 页面生成的 Key模型 ID 按你订阅的填。Claude Code 用户则走https://taotoken.net/claude-code-anthropic这个接入说明Codex 用户看https://taotoken.net/coding-plan。三件套永远是Base URL Key Model ID缺一不可。需要强调的是TaoToken 在这里的角色是模型调用的统一通道不替代 Android CLI 本身也不替代 Android Studio。CLI 负责执行命令Skills 负责注入知识TaoToken 负责让模型调用这条链路可控可查。三者职责分开出问题时才能定位到具体环节。如果你只是想让 Cursor Agent 跑通 Android CLI最小配置就是Cursor 里配好 TaoToken 的 Base URL 和 Key然后按下一节装 CLI 和 Skills。模型对话可以在https://taotoken.net/chat里先验证 Key 是否可用再去 Cursor 里配。3. 可复制配置环境变量与 Skills 片段这一节给的是能直接粘贴的配置。先装 CLI用 winget 最省事winget install -e --id Google.AndroidCLI --source winget装完关掉终端重开让 PATH 生效。验证android --version期望输出android 1.0.x。如果报 msstore 证书错误就是 winget 默认同时搜 msstore 源导致的加--source winget跳过即可。接着初始化 Agent 环境android init这会在%USERPROFILE%\.android-cli\建配置目录并把基础 Skillandroid-cli装到检测到的 Agent 目录。然后为 Cursor 显式安装核心 Skillsandroid skills add --agentcursor android-cli android skills add --agentcursor edge-to-edge android skills add --agentcursor r8-analyzer android skills add --agentcursor agp-9-upgrade注意语法skill 名称是位置参数写在命令末尾不支持--skillxxx写法。Claude Code 的标识是claude-code不是claude。环境变量这块Windows 上最容易踩的坑是ANDROID_HOME被写成多个路径。正确做法是只指向 SDK 根目录不含platform-tools$sdk $env:LOCALAPPDATA\Android\Sdk [Environment]::SetEnvironmentVariable(ANDROID_HOME, $sdk, User) [Environment]::SetEnvironmentVariable(ANDROID_SDK_ROOT, $sdk, User)platform-tools应该加进 PATH而不是拼进ANDROID_HOME。改完必须重启终端。如果不想每次敲--sdk可以写%USERPROFILE%\.androidrc每行一个默认参数--sdkC:\Users\你的用户名\AppData\Local\Android\SdkCursor 的 Skills 存放位置是%USERPROFILE%\.cursor\skills\项目级则是项目内.cursor/skills/。团队共享用项目级随 Git 走cd D:\your-android-project android skills add --project. r8-analyzer验证安装android skills list --long android infoCursor 在启动时扫描 Skills装完要重启 Cursor 或新开 Agent 会话才生效。4. 验证请求Cursor Agent 调用 CLI 跑通构建与部署配置对不对跑一遍就知道。先确认 CLI 和 Skills 状态android --version android skills list --long然后在 Cursor Agent 里输入帮我检查 android cli 是否配置正确并列出已安装的 skillsAgent 会调用android info和android skills list把结果读回来。如果 Skills 装好了它应该能说出android-cli、edge-to-edge这些名字。接着验证文档检索。在 Agent 里问查一下 Android 官方文档里 Navigation 3 多 back stack 怎么实现Agent 预期行为是执行android docs search Navigation 3 multiple back stacks拿到kb://开头的 URL再android docs fetch拉全文。这一步能跑通说明 Knowledge Base 通道正常。再验证项目创建和部署。先看模板android create list干跑一次不落盘android create --dry-run empty-activity-agp-9 -o D:\temp\demo正式创建android create empty-activity-agp-9 -o D:\Projects\DemoApp --nameDemoApp构建仍由 Gradle 负责cd D:\Projects\DemoApp .\gradlew assembleDebug部署用 CLIandroid run --apksapp\build\outputs\apk\debug\app-debug.apk指定设备adb devices android run --apksapp-debug.apk --deviceemulator-5554抓日志这块CLI 目前没有独立 log 子命令还是走 adbadb logcat -d logcat.txt在 Cursor Agent 里可以这样描述任务用 android cli 部署当前 debug 包到已连接设备然后抓最近 200 行 logcat 保存到 logcat.txtAgent 会组合android run和adb logcat完成。实测下来把这类重复命令交给 Agent 后手动敲命令的次数明显下降。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth排障按「CLI 层」和「模型调用层」分开看。CLI 层的报错先看android --version有没有输出。如果Get-Command android能找到路径但android --version无输出、退出码是-1073741515这是缺 Visual C 运行库android --version Write-Host exit: $LASTEXITCODE解决winget install -e --id Microsoft.VCRedist.2015.x64 --source winget如果android skills add报Invalid or unsupported command skills add说明 PATH 里旧版tools\android.bat排在新 CLI 前面。诊断Get-Command android -All | Format-Table Name, Source -AutoSize第一个结果是...\Android\Sdk\tools\android.bat就是它。重命名旧文件Rename-Item $env:LOCALAPPDATA\Android\Sdk\tools\android.bat android.bat.deprecated如果android init报InvalidPathException检查ANDROID_HOME是否含分号Write-Host Session ANDROID_HOME$env:ANDROID_HOME Write-Host User ANDROID_HOME$([Environment]::GetEnvironmentVariable(ANDROID_HOME,User))含;就按第 3 节重设成单一根目录。模型调用层的报错对照真实错误信息401 UnauthorizedKey 无效或没带上。检查 Cursor 里配的 TaoToken Key 是否和https://taotoken.net/api-keys生成的一致Base URL 是否是https://taotoken.net/api。local proxy failed本地代理配置冲突。检查系统代理设置和 Cursor 的网络配置确保没有多层代理叠加。reading choices相关报错通常是响应体格式不符合预期多半是 Base URL 或 Model ID 填错。确认三件套Base URL Key Model ID 都对得上。OAuth报错出现在 Claude Code 或 Codex 这类走 OAuth 的工具上。检查~/.codex/auth.json或对应凭证文件是否过期重新走一遍https://taotoken.net/claude-code-anthropic的接入流程。如果 Cursor 里看不到 Skill确认%USERPROFILE%\.cursor\skills\下有对应目录然后完全退出 Cursor 重启。自定义 Skill 被覆盖的问题官方提示是改过内容就重命名 Skill否则android skills add更新时会覆盖。6. 把重复命令交给 Agent把 Key 收进一个入口装完这套之后日常流程变成Cursor Agent 读 Skills 拿到领域知识调android命令执行 SDK 管理、项目创建、部署、文档检索构建仍走 Gradle深度分析走android studio桥接。Windows 上android emulator暂不可用模拟器还是用 Android Studio 的 AVD Manager 管。模型调用这条链路用 TaoToken 统一收口一个 Key、一个 API 地址Cursor、Claude Code、Codex 都指向同一处。这样 401 只可能来自一个地方排障不用在多个配置间跳。需要长期跑编码和 Agent 任务的可以看https://taotoken.net/coding-plan只是验证模型是否通的去https://taotoken.net/chat发一条消息最快。最后给个实用习惯每月跑一次android update和android skills add --agentcursor --all保持 CLI 和 Skill 索引同步。官方 Skill 库还在扩充AGP 升级、R8 优化、Navigation 3 迁移这些场景的 Skill 会持续更新跟上是成本最低的收益。