效率提升 3 倍)
1. Windows 上讓 Cursor Agent 真正會(huì)寫 Android 代碼Android CLI 是 Google 在 2026 年推出的終端工具鏈命令名就叫android它把 SDK 安裝、項(xiàng)目腳手架、設(shè)備部署、官方文檔檢索這些動(dòng)作統(tǒng)一成 Agent 能直接調(diào)用的標(biāo)準(zhǔn)命令。Android Skills 則是配套的指令包每個(gè) Skill 是一個(gè)帶SKILL.md的目錄Cursor 啟動(dòng)時(shí)掃描到它就能在合適的對話里自動(dòng)加載領(lǐng)域知識。這套組合最適合誰答案是在 Windows 上用 Cursor Agent 寫 Android、又不想每次手動(dòng)敲sdkmanager和adb的開發(fā)者。我自己的痛點(diǎn)是讓 Cursor 幫忙裝個(gè) SDK它會(huì)猜路徑讓它查 Navigation 3 的寫法它憑訓(xùn)練數(shù)據(jù)編。Android CLI 把這兩件事都變成可執(zhí)行命令Skills 則把「LLM 不擅長的領(lǐng)域知識」按需注入。官方博客給出的數(shù)字是 Agent 工作流效率提升約 3 倍主要來自減少 Token 消耗和試錯(cuò)次數(shù)。這篇按 Windows 從零搭建的順序?qū)懴妊b CLI再初始化 Skills然后給出可復(fù)制的配置片段最后用 Cursor Agent 實(shí)際跑一遍構(gòu)建、安裝、抓日志并說明怎么用 TaoToken 統(tǒng)一管理模型調(diào)用的 Key 和 API 通道。全程命令可直接復(fù)制。2. TaoToken 前置統(tǒng)一 Key 與 API 通道管理在動(dòng)手裝 CLI 之前先把模型調(diào)用的通道理清楚。Cursor Agent 背后要調(diào)模型如果你同時(shí)用 Claude Code、Codex、Cline 這些工具每個(gè)都配一遍 Key 和 Base URL 會(huì)很亂。TaoToken 的作用就是把這些調(diào)用收斂到一個(gè)入口一個(gè) Key、一個(gè) API 地址模型 ID 按需切換。它的 API 地址是https://taotoken.net/api控制臺(tái)在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 場景要提這個(gè)因?yàn)?Cursor Agent 在執(zhí)行android docs search、分析 R8 規(guī)則、遷移 Compose 這些任務(wù)時(shí)會(huì)頻繁調(diào)用模型。如果每個(gè)工具各配一套憑證排查問題時(shí)你分不清是 CLI 報(bào)錯(cuò)還是 Key 失效。統(tǒng)一通道后401 這類錯(cuò)誤只可能來自一個(gè)地方排障路徑短很多。具體做法是在 Cursor 的模型設(shè)置里把自定義 OpenAI 兼容端點(diǎn)指向 TaoToken 的 API 地址填入在 api-keys 頁面生成的 Key模型 ID 按你訂閱的填。Claude Code 用戶則走h(yuǎn)ttps://taotoken.net/claude-code-anthropic這個(gè)接入說明Codex 用戶看https://taotoken.net/coding-plan。三件套永遠(yuǎn)是Base URL Key Model ID缺一不可。需要強(qiáng)調(diào)的是TaoToken 在這里的角色是模型調(diào)用的統(tǒng)一通道不替代 Android CLI 本身也不替代 Android Studio。CLI 負(fù)責(zé)執(zhí)行命令Skills 負(fù)責(zé)注入知識TaoToken 負(fù)責(zé)讓模型調(diào)用這條鏈路可控可查。三者職責(zé)分開出問題時(shí)才能定位到具體環(huán)節(jié)。如果你只是想讓 Cursor Agent 跑通 Android CLI最小配置就是Cursor 里配好 TaoToken 的 Base URL 和 Key然后按下一節(jié)裝 CLI 和 Skills。模型對話可以在https://taotoken.net/chat里先驗(yàn)證 Key 是否可用再去 Cursor 里配。3. 可復(fù)制配置環(huán)境變量與 Skills 片段這一節(jié)給的是能直接粘貼的配置。先裝 CLI用 winget 最省事winget install -e --id Google.AndroidCLI --source winget裝完關(guān)掉終端重開讓 PATH 生效。驗(yàn)證android --version期望輸出android 1.0.x。如果報(bào) msstore 證書錯(cuò)誤就是 winget 默認(rèn)同時(shí)搜 msstore 源導(dǎo)致的加--source winget跳過即可。接著初始化 Agent 環(huán)境android init這會(huì)在%USERPROFILE%\.android-cli\建配置目錄并把基礎(chǔ) 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 的標(biāo)識是claude-code不是claude。環(huán)境變量這塊Windows 上最容易踩的坑是ANDROID_HOME被寫成多個(gè)路徑。正確做法是只指向 SDK 根目錄不含platform-tools$sdk $env:LOCALAPPDATA\Android\Sdk [Environment]::SetEnvironmentVariable(ANDROID_HOME, $sdk, User) [Environment]::SetEnvironmentVariable(ANDROID_SDK_ROOT, $sdk, User)platform-tools應(yīng)該加進(jìn) PATH而不是拼進(jìn)ANDROID_HOME。改完必須重啟終端。如果不想每次敲--sdk可以寫%USERPROFILE%\.androidrc每行一個(gè)默認(rèn)參數(shù)--sdkC:\Users\你的用戶名\AppData\Local\Android\SdkCursor 的 Skills 存放位置是%USERPROFILE%\.cursor\skills\項(xiàng)目級則是項(xiàng)目內(nèi).cursor/skills/。團(tuán)隊(duì)共享用項(xiàng)目級隨 Git 走cd D:\your-android-project android skills add --project. r8-analyzer驗(yàn)證安裝android skills list --long android infoCursor 在啟動(dòng)時(shí)掃描 Skills裝完要重啟 Cursor 或新開 Agent 會(huì)話才生效。4. 驗(yàn)證請求Cursor Agent 調(diào)用 CLI 跑通構(gòu)建與部署配置對不對跑一遍就知道。先確認(rèn) CLI 和 Skills 狀態(tài)android --version android skills list --long然后在 Cursor Agent 里輸入幫我檢查 android cli 是否配置正確并列出已安裝的 skillsAgent 會(huì)調(diào)用android info和android skills list把結(jié)果讀回來。如果 Skills 裝好了它應(yīng)該能說出android-cli、edge-to-edge這些名字。接著驗(yàn)證文檔檢索。在 Agent 里問查一下 Android 官方文檔里 Navigation 3 多 back stack 怎么實(shí)現(xiàn)Agent 預(yù)期行為是執(zhí)行android docs search Navigation 3 multiple back stacks拿到kb://開頭的 URL再android docs fetch拉全文。這一步能跑通說明 Knowledge Base 通道正常。再驗(yàn)證項(xiàng)目創(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構(gòu)建仍由 Gradle 負(fù)責(zé)cd D:\Projects\DemoApp .\gradlew assembleDebug部署用 CLIandroid run --apksapp\build\outputs\apk\debug\app-debug.apk指定設(shè)備adb devices android run --apksapp-debug.apk --deviceemulator-5554抓日志這塊CLI 目前沒有獨(dú)立 log 子命令還是走 adbadb logcat -d logcat.txt在 Cursor Agent 里可以這樣描述任務(wù)用 android cli 部署當(dāng)前 debug 包到已連接設(shè)備然后抓最近 200 行 logcat 保存到 logcat.txtAgent 會(huì)組合android run和adb logcat完成。實(shí)測下來把這類重復(fù)命令交給 Agent 后手動(dòng)敲命令的次數(shù)明顯下降。5. 本篇常見錯(cuò)排查401、local proxy failed、reading choices、OAuth排障按「CLI 層」和「模型調(diào)用層」分開看。CLI 層的報(bào)錯(cuò)先看android --version有沒有輸出。如果Get-Command android能找到路徑但android --version無輸出、退出碼是-1073741515這是缺 Visual C 運(yùn)行庫android --version Write-Host exit: $LASTEXITCODE解決winget install -e --id Microsoft.VCRedist.2015.x64 --source winget如果android skills add報(bào)Invalid or unsupported command skills add說明 PATH 里舊版tools\android.bat排在新 CLI 前面。診斷Get-Command android -All | Format-Table Name, Source -AutoSize第一個(gè)結(jié)果是...\Android\Sdk\tools\android.bat就是它。重命名舊文件Rename-Item $env:LOCALAPPDATA\Android\Sdk\tools\android.bat android.bat.deprecated如果android init報(bào)InvalidPathException檢查ANDROID_HOME是否含分號Write-Host Session ANDROID_HOME$env:ANDROID_HOME Write-Host User ANDROID_HOME$([Environment]::GetEnvironmentVariable(ANDROID_HOME,User))含;就按第 3 節(jié)重設(shè)成單一根目錄。模型調(diào)用層的報(bào)錯(cuò)對照真實(shí)錯(cuò)誤信息401 UnauthorizedKey 無效或沒帶上。檢查 Cursor 里配的 TaoToken Key 是否和https://taotoken.net/api-keys生成的一致Base URL 是否是https://taotoken.net/api。local proxy failed本地代理配置沖突。檢查系統(tǒng)代理設(shè)置和 Cursor 的網(wǎng)絡(luò)配置確保沒有多層代理疊加。reading choices相關(guān)報(bào)錯(cuò)通常是響應(yīng)體格式不符合預(yù)期多半是 Base URL 或 Model ID 填錯(cuò)。確認(rèn)三件套Base URL Key Model ID 都對得上。OAuth報(bào)錯(cuò)出現(xiàn)在 Claude Code 或 Codex 這類走 OAuth 的工具上。檢查~/.codex/auth.json或?qū)?yīng)憑證文件是否過期重新走一遍https://taotoken.net/claude-code-anthropic的接入流程。如果 Cursor 里看不到 Skill確認(rèn)%USERPROFILE%\.cursor\skills\下有對應(yīng)目錄然后完全退出 Cursor 重啟。自定義 Skill 被覆蓋的問題官方提示是改過內(nèi)容就重命名 Skill否則android skills add更新時(shí)會(huì)覆蓋。6. 把重復(fù)命令交給 Agent把 Key 收進(jìn)一個(gè)入口裝完這套之后日常流程變成Cursor Agent 讀 Skills 拿到領(lǐng)域知識調(diào)android命令執(zhí)行 SDK 管理、項(xiàng)目創(chuàng)建、部署、文檔檢索構(gòu)建仍走 Gradle深度分析走android studio橋接。Windows 上android emulator暫不可用模擬器還是用 Android Studio 的 AVD Manager 管。模型調(diào)用這條鏈路用 TaoToken 統(tǒng)一收口一個(gè) Key、一個(gè) API 地址Cursor、Claude Code、Codex 都指向同一處。這樣 401 只可能來自一個(gè)地方排障不用在多個(gè)配置間跳。需要長期跑編碼和 Agent 任務(wù)的可以看https://taotoken.net/coding-plan只是驗(yàn)證模型是否通的去https://taotoken.net/chat發(fā)一條消息最快。最后給個(gè)實(shí)用習(xí)慣每月跑一次android update和android skills add --agentcursor --all保持 CLI 和 Skill 索引同步。官方 Skill 庫還在擴(kuò)充AGP 升級、R8 優(yōu)化、Navigation 3 遷移這些場景的 Skill 會(huì)持續(xù)更新跟上是成本最低的收益。 Google Android CLI 完全指南：Windows 下安裝 Android CLI 與 Skills，讓 Cursor Agent 開發(fā)效率提升 3 倍
1. Windows 上讓 Cursor Agent 真正會(huì)寫 Android 代碼Android CLI 是 Google 在 2026 年推出的終端工具鏈命令名就叫android它把 SDK 安裝、項(xiàng)目腳手架、設(shè)備部署、官方文檔檢索這些動(dòng)作統(tǒng)一成 Agent 能直接調(diào)用的標(biāo)準(zhǔn)命令。Android Skills 則是配套的指令包每個(gè) Skill 是一個(gè)帶SKILL.md的目錄Cursor 啟動(dòng)時(shí)掃描到它就能在合適的對話里自動(dòng)加載領(lǐng)域知識。這套組合最適合誰答案是在 Windows 上用 Cursor Agent 寫 Android、又不想每次手動(dòng)敲sdkmanager和adb的開發(fā)者。我自己的痛點(diǎn)是讓 Cursor 幫忙裝個(gè) SDK它會(huì)猜路徑讓它查 Navigation 3 的寫法它憑訓(xùn)練數(shù)據(jù)編。Android CLI 把這兩件事都變成可執(zhí)行命令Skills 則把「LLM 不擅長的領(lǐng)域知識」按需注入。官方博客給出的數(shù)字是 Agent 工作流效率提升約 3 倍主要來自減少 Token 消耗和試錯(cuò)次數(shù)。這篇按 Windows 從零搭建的順序?qū)懴妊b CLI再初始化 Skills然后給出可復(fù)制的配置片段最后用 Cursor Agent 實(shí)際跑一遍構(gòu)建、安裝、抓日志并說明怎么用 TaoToken 統(tǒng)一管理模型調(diào)用的 Key 和 API 通道。全程命令可直接復(fù)制。2. TaoToken 前置統(tǒng)一 Key 與 API 通道管理在動(dòng)手裝 CLI 之前先把模型調(diào)用的通道理清楚。Cursor Agent 背后要調(diào)模型如果你同時(shí)用 Claude Code、Codex、Cline 這些工具每個(gè)都配一遍 Key 和 Base URL 會(huì)很亂。TaoToken 的作用就是把這些調(diào)用收斂到一個(gè)入口一個(gè) Key、一個(gè) API 地址模型 ID 按需切換。它的 API 地址是https://taotoken.net/api控制臺(tái)在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 場景要提這個(gè)因?yàn)?Cursor Agent 在執(zhí)行android docs search、分析 R8 規(guī)則、遷移 Compose 這些任務(wù)時(shí)會(huì)頻繁調(diào)用模型。如果每個(gè)工具各配一套憑證排查問題時(shí)你分不清是 CLI 報(bào)錯(cuò)還是 Key 失效。統(tǒng)一通道后401 這類錯(cuò)誤只可能來自一個(gè)地方排障路徑短很多。具體做法是在 Cursor 的模型設(shè)置里把自定義 OpenAI 兼容端點(diǎn)指向 TaoToken 的 API 地址填入在 api-keys 頁面生成的 Key模型 ID 按你訂閱的填。Claude Code 用戶則走h(yuǎn)ttps://taotoken.net/claude-code-anthropic這個(gè)接入說明Codex 用戶看https://taotoken.net/coding-plan。三件套永遠(yuǎn)是Base URL Key Model ID缺一不可。需要強(qiáng)調(diào)的是TaoToken 在這里的角色是模型調(diào)用的統(tǒng)一通道不替代 Android CLI 本身也不替代 Android Studio。CLI 負(fù)責(zé)執(zhí)行命令Skills 負(fù)責(zé)注入知識TaoToken 負(fù)責(zé)讓模型調(diào)用這條鏈路可控可查。三者職責(zé)分開出問題時(shí)才能定位到具體環(huán)節(jié)。如果你只是想讓 Cursor Agent 跑通 Android CLI最小配置就是Cursor 里配好 TaoToken 的 Base URL 和 Key然后按下一節(jié)裝 CLI 和 Skills。模型對話可以在https://taotoken.net/chat里先驗(yàn)證 Key 是否可用再去 Cursor 里配。3. 可復(fù)制配置環(huán)境變量與 Skills 片段這一節(jié)給的是能直接粘貼的配置。先裝 CLI用 winget 最省事winget install -e --id Google.AndroidCLI --source winget裝完關(guān)掉終端重開讓 PATH 生效。驗(yàn)證android --version期望輸出android 1.0.x。如果報(bào) msstore 證書錯(cuò)誤就是 winget 默認(rèn)同時(shí)搜 msstore 源導(dǎo)致的加--source winget跳過即可。接著初始化 Agent 環(huán)境android init這會(huì)在%USERPROFILE%\.android-cli\建配置目錄并把基礎(chǔ) 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 的標(biāo)識是claude-code不是claude。環(huán)境變量這塊Windows 上最容易踩的坑是ANDROID_HOME被寫成多個(gè)路徑。正確做法是只指向 SDK 根目錄不含platform-tools$sdk $env:LOCALAPPDATA\Android\Sdk [Environment]::SetEnvironmentVariable(ANDROID_HOME, $sdk, User) [Environment]::SetEnvironmentVariable(ANDROID_SDK_ROOT, $sdk, User)platform-tools應(yīng)該加進(jìn) PATH而不是拼進(jìn)ANDROID_HOME。改完必須重啟終端。如果不想每次敲--sdk可以寫%USERPROFILE%\.androidrc每行一個(gè)默認(rèn)參數(shù)--sdkC:\Users\你的用戶名\AppData\Local\Android\SdkCursor 的 Skills 存放位置是%USERPROFILE%\.cursor\skills\項(xiàng)目級則是項(xiàng)目內(nèi).cursor/skills/。團(tuán)隊(duì)共享用項(xiàng)目級隨 Git 走cd D:\your-android-project android skills add --project. r8-analyzer驗(yàn)證安裝android skills list --long android infoCursor 在啟動(dòng)時(shí)掃描 Skills裝完要重啟 Cursor 或新開 Agent 會(huì)話才生效。4. 驗(yàn)證請求Cursor Agent 調(diào)用 CLI 跑通構(gòu)建與部署配置對不對跑一遍就知道。先確認(rèn) CLI 和 Skills 狀態(tài)android --version android skills list --long然后在 Cursor Agent 里輸入幫我檢查 android cli 是否配置正確并列出已安裝的 skillsAgent 會(huì)調(diào)用android info和android skills list把結(jié)果讀回來。如果 Skills 裝好了它應(yīng)該能說出android-cli、edge-to-edge這些名字。接著驗(yàn)證文檔檢索。在 Agent 里問查一下 Android 官方文檔里 Navigation 3 多 back stack 怎么實(shí)現(xiàn)Agent 預(yù)期行為是執(zhí)行android docs search Navigation 3 multiple back stacks拿到kb://開頭的 URL再android docs fetch拉全文。這一步能跑通說明 Knowledge Base 通道正常。再驗(yàn)證項(xiàng)目創(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構(gòu)建仍由 Gradle 負(fù)責(zé)cd D:\Projects\DemoApp .\gradlew assembleDebug部署用 CLIandroid run --apksapp\build\outputs\apk\debug\app-debug.apk指定設(shè)備adb devices android run --apksapp-debug.apk --deviceemulator-5554抓日志這塊CLI 目前沒有獨(dú)立 log 子命令還是走 adbadb logcat -d logcat.txt在 Cursor Agent 里可以這樣描述任務(wù)用 android cli 部署當(dāng)前 debug 包到已連接設(shè)備然后抓最近 200 行 logcat 保存到 logcat.txtAgent 會(huì)組合android run和adb logcat完成。實(shí)測下來把這類重復(fù)命令交給 Agent 后手動(dòng)敲命令的次數(shù)明顯下降。5. 本篇常見錯(cuò)排查401、local proxy failed、reading choices、OAuth排障按「CLI 層」和「模型調(diào)用層」分開看。CLI 層的報(bào)錯(cuò)先看android --version有沒有輸出。如果Get-Command android能找到路徑但android --version無輸出、退出碼是-1073741515這是缺 Visual C 運(yùn)行庫android --version Write-Host exit: $LASTEXITCODE解決winget install -e --id Microsoft.VCRedist.2015.x64 --source winget如果android skills add報(bào)Invalid or unsupported command skills add說明 PATH 里舊版tools\android.bat排在新 CLI 前面。診斷Get-Command android -All | Format-Table Name, Source -AutoSize第一個(gè)結(jié)果是...\Android\Sdk\tools\android.bat就是它。重命名舊文件Rename-Item $env:LOCALAPPDATA\Android\Sdk\tools\android.bat android.bat.deprecated如果android init報(bào)InvalidPathException檢查ANDROID_HOME是否含分號Write-Host Session ANDROID_HOME$env:ANDROID_HOME Write-Host User ANDROID_HOME$([Environment]::GetEnvironmentVariable(ANDROID_HOME,User))含;就按第 3 節(jié)重設(shè)成單一根目錄。模型調(diào)用層的報(bào)錯(cuò)對照真實(shí)錯(cuò)誤信息401 UnauthorizedKey 無效或沒帶上。檢查 Cursor 里配的 TaoToken Key 是否和https://taotoken.net/api-keys生成的一致Base URL 是否是https://taotoken.net/api。local proxy failed本地代理配置沖突。檢查系統(tǒng)代理設(shè)置和 Cursor 的網(wǎng)絡(luò)配置確保沒有多層代理疊加。reading choices相關(guān)報(bào)錯(cuò)通常是響應(yīng)體格式不符合預(yù)期多半是 Base URL 或 Model ID 填錯(cuò)。確認(rèn)三件套Base URL Key Model ID 都對得上。OAuth報(bào)錯(cuò)出現(xiàn)在 Claude Code 或 Codex 這類走 OAuth 的工具上。檢查~/.codex/auth.json或?qū)?yīng)憑證文件是否過期重新走一遍https://taotoken.net/claude-code-anthropic的接入流程。如果 Cursor 里看不到 Skill確認(rèn)%USERPROFILE%\.cursor\skills\下有對應(yīng)目錄然后完全退出 Cursor 重啟。自定義 Skill 被覆蓋的問題官方提示是改過內(nèi)容就重命名 Skill否則android skills add更新時(shí)會(huì)覆蓋。6. 把重復(fù)命令交給 Agent把 Key 收進(jìn)一個(gè)入口裝完這套之后日常流程變成Cursor Agent 讀 Skills 拿到領(lǐng)域知識調(diào)android命令執(zhí)行 SDK 管理、項(xiàng)目創(chuàng)建、部署、文檔檢索構(gòu)建仍走 Gradle深度分析走android studio橋接。Windows 上android emulator暫不可用模擬器還是用 Android Studio 的 AVD Manager 管。模型調(diào)用這條鏈路用 TaoToken 統(tǒng)一收口一個(gè) Key、一個(gè) API 地址Cursor、Claude Code、Codex 都指向同一處。這樣 401 只可能來自一個(gè)地方排障不用在多個(gè)配置間跳。需要長期跑編碼和 Agent 任務(wù)的可以看https://taotoken.net/coding-plan只是驗(yàn)證模型是否通的去https://taotoken.net/chat發(fā)一條消息最快。最后給個(gè)實(shí)用習(xí)慣每月跑一次android update和android skills add --agentcursor --all保持 CLI 和 Skill 索引同步。官方 Skill 庫還在擴(kuò)充AGP 升級、R8 優(yōu)化、Navigation 3 遷移這些場景的 Skill 會(huì)持續(xù)更新跟上是成本最低的收益。