Claude Code 寫安卓 App：Android Studio 建項目、讓它用 gradlew 編譯安裝，報錯和日誌怎麼餵給它

本文根據 Claude Code 官方《Best practices for Claude Code》《Common workflows》和 Android 開發者官方文檔《Build your app from the command line》《Android Debug Bridge》《Test from the command line》整理，資料核對於 2026-11-05。配圖為本站整理的示意圖，不是介面截圖。本站（bigolab.com）不是 Anthropic 或 Google 官方網站。

適用於誰

• 想做一個自己的安卓小應用，但不熟悉安卓開發的人；
• 會寫一點代碼，想讓 Claude Code 加速的安卓開發者；
• 不知道 Claude Code 怎麼「看到」App 運行結果的人。

結論先說

1. 官方沒有專門的安卓教學，但安卓官方文檔給了完整的命令行構建方法：用 Gradle 包裝腳本（Windows 命令提示符用 gradlew，Mac、Linux 和 Windows PowerShell 用 ./gradlew）。Claude Code 能在終端裏運行這些命令，所以它能自己編譯、讀報錯、修改。
2. 項目和模擬器建議用 Android Studio 建。安卓官方文檔說，使用模擬器要先在 Android Studio 裏創建虛擬裝置（AVD）。
3. 給 Claude 一個能判斷對錯的檢查：Claude Code 官方最佳實踐強調，構建的退出碼、測試、檢查工具都可以做這個檢查。安卓裏最直接的就是 gradlew assembleDebug 能不能通過。
4. Claude 看不到你的手機螢幕，除非你貼截圖。它靠編譯結果、測試結果和日誌（logcat）來判斷。官方提示詞建議裏就有「直接把截圖粘貼進提示詞」這一條。
5. 流程是：先讓它在計劃模式給方案，再小步實現，每一步編譯通過後再繼續。

圖：本站根據 Android 官方：命令行構建 整理的示意圖

第零步：環境準備

先安裝 Android Studio（用它創建項目、管理 SDK 和虛擬裝置）。用 Android Studio 新建一個空白項目，選你想用的模板。創建好後，在項目根目錄啟動 Claude Code。這一步不要讓 Claude 代勞，因為項目模板、SDK 版本這些需要你的選擇。Claude Code 本身的安裝見 /guides/claude-code-getting-started；Windows 用戶的路徑和終端問題見 /guides/claude-code-windows-pitfalls-paths-git-bash-powershell。

第一步：寫 CLAUDE.md，告訴它怎麼構建

官方說，CLAUDE.md 最有用的一行是「跑檢查的命令」。安卓項目可以這樣寫：

text
# 構建與測試命令
- 編譯調試版：./gradlew assembleDebug（Windows 命令提示符用 gradlew assembleDebug）
- 本地單元測試：./gradlew test
- 安裝到已連接的裝置或模擬器：./gradlew installDebug
# 約定
- 代碼在 app/src/main/ 下；不要修改 gradle 版本和 SDK 版本，除非我明確要求
- 不要提交 local.properties 和任何簽名密鑰文件

CLAUDE.md 的寫法見 /guides/claude-md-agents-md。

第二步：讓它在計劃模式設計功能

提示詞 1：先出方案，不寫代碼

text
我想做一個【記帳 App：可以添加一筆支出、按日期查看列表、按類別統計】。
請先閱讀當前項目的結構和模板，然後在計劃模式裏給出方案：
1）要新增和修改的文件；2）數據怎麼儲存（說明理由，選最簡單可行的）；3）介面分幾個頁面、各自功能；4）分幾步實現，每一步完成後我怎麼驗證。
先不要寫代碼。

計劃模式的用法見 /guides/claude-code-plan-mode。

第三步：小步實現，每步都編譯

提示詞 2：實現一步，並用編譯驗證

text
請實現方案的第 1 步：【添加支出的頁面和儲存功能】。
完成後運行 ./gradlew assembleDebug。如果編譯失敗，請讀報錯原文，修復後再次編譯，直到通過。
最後告訴我：你改了哪些文件、編譯命令的最終結果、以及我在模擬器裏應該怎麼操作來驗證這一步。
不要一次做多步。

安卓官方文檔說明，assembleDebug 會在 module_name/build/outputs/apk/ 下生成名為 module_name-debug.apk 的文件，已用調試密鑰簽名，可以直接安裝；installDebug 則是編譯後立刻安裝到正在運行的模擬器或已連接的裝置。任務名裏的 Debug 是構建變體名的駝峰寫法，你的項目有別的變體或產品風味，用 gradlew tasks 可以看到所有任務。

第四步：在模擬器或真機上運行

• 模擬器：先在 Android Studio 的 Device Manager 裏創建虛擬裝置（官方文檔：從歡迎介面選 More Actions，再選 Virtual Device Manager）。命令行裏可以用 emulator -list-avds 查看裝置名，用 emulator -avd 裝置名 啟動，官方的命令行文檔裏有這兩條。
• 真機：需要先在手機上打開 USB 調試。官方的路徑是：設定裏的「開發者選項」，該選項在 Android 4.2 及以上預設隱藏，要到「關於手機」裏連續點擊「版本號」七次才會出現。連好後運行 adb devices 確認裝置被識別，官方文檔說連接成功會在列表裏顯示為 device。
• 安裝也可以用 adb install 路徑/你的.apk，官方文檔裏就是這個命令。

Claude 看不到螢幕，所以運行後的介面問題要你來描述或貼截圖。

第五步：用測試和日誌閉環

安卓官方的命令行測試文檔給了兩類測試：本地單元測試用 ./gradlew test，結果在模組的 build/reports/tests/ 目錄；需要裝置的儀器測試用 ./gradlew connectedAndroidTest，結果在 build/reports/androidTests/connected/。

提示詞 3：給功能補測試並運行

text
請為剛實現的【支出儲存和統計邏輯】補充本地單元測試，覆蓋：正常數據、空數據、金額為 0 或負數、日期邊界。
運行 ./gradlew test，失敗就讀報告並修復，直到全部通過。注意：不要為了讓測試通過而修改測試的預期結果，除非你先向我說明理由。

App 在裝置上崩潰時，讓 Claude 看日誌。安卓官方的 logcat 文檔裏 adb logcat 可以按級別過濾，例如 adb logcat :W 只看警告以上，adb logcat ActivityManager:I MyApp:D :S 只看指定標籤。

提示詞 4：崩潰日誌排查

text
App 在【點擊儲存按鈕】時崩潰。請運行 adb logcat *:E 抓取錯誤日誌（我會先復現一次崩潰），找出異常的類型、出錯的代碼位置，解釋原因，再提出最小的修復方案。
先說明原因和方案，我確認後再改代碼。日誌裏如果有個人資訊，不要複述。

圖：本站根據官方文檔整理的示意圖

注意事項

• 不要把簽名密鑰和 local.properties 提交進倉庫。 這是通用的安全做法，涉及密鑰的原則見 /guides/ai-coding-security-secrets-permissions。
• 發佈到應用商店要用簽名的發佈版（release）。官方文檔說發佈版要用你的私鑰簽名，這一步涉及密鑰，建議自己完成，別讓 AI 處理。
• 沒有 Android Studio 也能用命令行構建，但創建項目、管理虛擬裝置用它最省事。

常見問題

Q：編譯報錯看不懂？

把完整報錯原文交給 Claude，說明你做了什麼改動。官方「Fix bugs efficiently」工作流的第一步就是把報錯交給 Claude，別隻說「編譯不過」。

Q：Windows 上 ./gradlew 不能運行？

安卓官方文檔說明：Windows 命令提示符用 gradlew，PowerShell 用 ./gradlew。Claude Code 在 Windows 上用 Git Bash 或 PowerShell 執行命令，具體見 /guides/claude-code-windows-pitfalls-paths-git-bash-powershell。

訂閱和額度

安卓構建的輸出很長，報錯會佔不少上下文，建議按功能分會話。訂閱選擇見 /chongzhi/claude-code，價格和額度以官方頁面當前顯示為準。

相關教學

• /guides/claude-code-getting-started：Claude Code 入門
• /guides/claude-code-plan-mode：計劃模式
• /guides/claude-code-build-frontend-project-react-vue：從零搭前端項目

參考資料

• Claude Code 文檔：Best practices for Claude Code — https://code.claude.com/docs/en/best-practices
• Android 開發者：Build your app from the command line — https://developer.android.com/build/building-cmdline
• Android 開發者：Android Debug Bridge (adb) — https://developer.android.com/studio/command-line/adb
• Android 開發者：Test from the command line — https://developer.android.com/studio/test/command-line
• Android 開發者：Logcat command-line tool — https://developer.android.com/studio/command-line/logcat