1. Windows 上讓 Cursor Agent 真正會寫 Android 代碼Android CLI 是 Google 在 2026 年推出的終端工具鏈命令名就叫android它把 SDK 安裝、項目腳手架、設備部署、官方文檔檢索這些動作統(tǒng)一成 Agent 能直接調用的標準命令。Android Skills 則是配套的指令包每個 Skill 是一個帶SKILL.md的目錄Cursor 啟動時掃描到它就能在合適的對話里自動加載領域知識。這套組合最適合誰答案是在 Windows 上用 Cursor Agent 寫 Android、又不想每次手動敲sdkmanager和adb的開發(fā)者。我自己的痛點是讓 Cursor 幫忙裝個 SDK它會猜路徑讓它查 Navigation 3 的寫法它憑訓練數(shù)據(jù)編。Android CLI 把這兩件事都變成可執(zhí)行命令Skills 則把「LLM 不擅長的領域知識」按需注入。官方博客給出的數(shù)字是 Agent 工作流效率提升約 3 倍主要來自減少 Token 消耗和試錯次數(shù)。這篇按 Windows 從零搭建的順序寫先裝 CLI再初始化 Skills然后給出可復制的配置片段最后用 Cursor Agent 實際跑一遍構建、安裝、抓日志并說明怎么用 TaoToken 統(tǒng)一管理模型調用的 Key 和 API 通道。全程命令可直接復制。2. TaoToken 前置統(tǒng)一 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。官網(wǎng)是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。為什么 Android CLI 場景要提這個因為 Cursor Agent 在執(zhí)行android docs search、分析 R8 規(guī)則、遷移 Compose 這些任務時會頻繁調用模型。如果每個工具各配一套憑證排查問題時你分不清是 CLI 報錯還是 Key 失效。統(tǒng)一通道后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 在這里的角色是模型調用的統(tǒng)一通道不替代 Android CLI 本身也不替代 Android Studio。CLI 負責執(zhí)行命令Skills 負責注入知識TaoToken 負責讓模型調用這條鏈路可控可查。三者職責分開出問題時才能定位到具體環(huán)節(jié)。如果你只是想讓 Cursor Agent 跑通 Android CLI最小配置就是Cursor 里配好 TaoToken 的 Base URL 和 Key然后按下一節(jié)裝 CLI 和 Skills。模型對話可以在https://taotoken.net/chat里先驗證 Key 是否可用再去 Cursor 里配。3. 可復制配置環(huán)境變量與 Skills 片段這一節(jié)給的是能直接粘貼的配置。先裝 CLI用 winget 最省事winget install -e --id Google.AndroidCLI --source winget裝完關掉終端重開讓 PATH 生效。驗證android --version期望輸出android 1.0.x。如果報 msstore 證書錯誤就是 winget 默認同時搜 msstore 源導致的加--source winget跳過即可。接著初始化 Agent 環(huán)境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 名稱是位置參數(shù)寫在命令末尾不支持--skillxxx寫法。Claude Code 的標識是claude-code不是claude。環(huán)境變量這塊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每行一個默認參數(shù)--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 狀態(tài)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 怎么實現(xiàn)Agent 預期行為是執(zhí)行android docs search Navigation 3 multiple back stacks拿到kb://開頭的 URL再android docs fetch拉全文。這一步能跑通說明 Knowledge Base 通道正常。再驗證項目創(chuàng)建和部署。先看模板android create list干跑一次不落盤android create --dry-run empty-activity-agp-9 -o D:\temp\demo正式創(chuàng)建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 后手動敲命令的次數(shù)明顯下降。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 節(jié)重設成單一根目錄。模型調用層的報錯對照真實錯誤信息401 UnauthorizedKey 無效或沒帶上。檢查 Cursor 里配的 TaoToken Key 是否和https://taotoken.net/api-keys生成的一致Base URL 是否是https://taotoken.net/api。local proxy failed本地代理配置沖突。檢查系統(tǒng)代理設置和 Cursor 的網(wǎng)絡配置確保沒有多層代理疊加。reading choices相關報錯通常是響應體格式不符合預期多半是 Base URL 或 Model ID 填錯。確認三件套Base URL Key Model ID 都對得上。OAuth報錯出現(xiàn)在 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命令執(zhí)行 SDK 管理、項目創(chuàng)建、部署、文檔檢索構建仍走 Gradle深度分析走android studio橋接。Windows 上android emulator暫不可用模擬器還是用 Android Studio 的 AVD Manager 管。模型調用這條鏈路用 TaoToken 統(tǒng)一收口一個 Key、一個 API 地址Cursor、Claude Code、Codex 都指向同一處。這樣 401 只可能來自一個地方排障不用在多個配置間跳。需要長期跑編碼和 Agent 任務的可以看https://taotoken.net/coding-plan只是驗證模型是否通的去https://taotoken.net/chat發(fā)一條消息最快。最后給個實用習慣每月跑一次android update和android skills add --agentcursor --all保持 CLI 和 Skill 索引同步。官方 Skill 庫還在擴充AGP 升級、R8 優(yōu)化、Navigation 3 遷移這些場景的 Skill 會持續(xù)更新跟上是成本最低的收益。