artemis-claude-code.md
La guida di questa pagina in un file: le cinque avvertenze, i comandi in ordine e i prompt per Claude Code. Le parti da cambiare sono tra parentesi quadre.
Scarica · MD ↓ARTEMIS è il tool open source di Google che fa usare un telefono Android a un agente AI: apre le app, tocca, scrive, cambia le impostazioni e ti riporta il risultato. Si collega a Claude Code con un server MCP. Qui trovi i limiti da sapere prima, l'installazione passo per passo e i prompt per le prime prove.
ARTEMIS sta sul GitHub di Google, con licenza Apache 2.0. È nato per testare le app: gli scrivi cosa fare con parole normali e lui lo fa sul telefono guardando lo schermo, come una persona. Quando un elemento non ha un nome leggibile lo trova con la vista.
Su AndroidWorld, il test di Google Research per gli agenti su Android, dichiara il 99,1% di compiti riusciti al primo tentativo (pass@1) su 116 compiti in più di 20 app. Nello stesso grafico una persona arriva all'80%. Il numero è loro, pubblicato nel README.
Lavora in due modi. Flash guarda, decide e tocca in 3-5 secondi a passo: va bene per i compiti semplici. Pro scrive un piano, controlla ogni azione prima di farla e verifica il risultato, con 15-40 secondi a passo: è per i lavori lunghi.
Ti servono git e un telefono Android con il cavo. Va bene anche l'emulatore. Il progetto chiede Python 3.12 o più recente. Lo script di avvio controlla e installa da solo ADB, scrcpy, FFmpeg e le dipendenze Python con uv.
Poi dal terminale scarichi ARTEMIS e lo avvii:
git clone https://github.com/google/artemis.git && cd artemis ./start.sh
git clone https://github.com/google/artemis.git cd artemis .\start.bat
Lo script ti chiede anche se collegare il server MCP agli agenti che trova sul computer: a Claude Code rispondi sì. Poi crei il file con la chiave del modello:
cp .env.example .env
Apri .env e riempi una riga sola, per esempio GEMINI_API_KEY= oppure ANTHROPIC_API_KEY=. Se usi il tuo telefono personale, in fondo allo stesso file cambia queste due righe:
ARTEMIS_HELPER_AUTO_INSTALL=false ARTEMIS_KEEP_DEVICE_AWAKE=false
La prima fa installare l'app di servizio solo quando lo decidi tu, con uv run artemis helper install. La seconda lascia spegnere lo schermo come sempre. L'app la togli quando vuoi con uv run artemis helper uninstall.
Nel browser si apre http://localhost:8000: una procedura guidata per collegare il telefono, lo schermo in diretta e un campo per scrivere i comandi. Prima prova dal terminale:
uv run artemis run "Apri Impostazioni, vai su Batteria e dimmi la percentuale attuale" --profile flash
Se allo script di avvio hai detto no, lo colleghi dopo dalla cartella di ARTEMIS. Il comando installa il server MCP e le regole di lavoro in ~/.claude/rules/artemis.md:
uv run artemis mcp --install claude
Con --install all lo collega a tutti gli agenti che trova: Claude Code, Codex, Cursor, Windsurf, VS Code e altri. Riapri Claude Code e scrivi /mcp per vedere se c'è artemis. Gli strumenti principali sono tre: mobile_run_task lancia un compito, mobile_get_device_state guarda il telefono, mobile_diagnose ti dice cosa sistemare quando qualcosa non parte.
Usa ARTEMIS sul telefono collegato, con il profilo flash. Apri Google Maps, calcola il tempo in auto da [Milano Centrale] a [Bergamo] e da [Bergamo] a [Brescia], poi dimmi il totale. Alla fine mandami uno screenshot dell'ultima schermata.
Usa ARTEMIS con il profilo pro. Installa sul telefono collegato l'APK [app-debug.apk] che trovi in questa cartella. Apri la schermata di login, entra con l'account di prova [[email protected]] e controlla se dopo il login compaiono popup inattesi. Alla fine dammi un rapporto con gli screenshot della pagina finale e gli errori del log.
ARTEMIS non funziona. Usa mobile_diagnose, dimmi cosa non va e sistema tu quello che si può sistemare dal computer.
Avvertenze, installazione, le righe del file .env e i tre prompt. Tienilo aperto la prima volta che colleghi il telefono.
La guida di questa pagina in un file: le cinque avvertenze, i comandi in ordine e i prompt per Claude Code. Le parti da cambiare sono tra parentesi quadre.
Scarica · MD ↓Mezz'ora per collegare il telefono e fare la prima prova. Poi ARTEMIS ripete al posto tuo i giri che fai a mano sul telefono. I test delle tue app li lanci da Claude Code.
Se vuoi impararlo per bene, dal primo comando a Claude Code, c'è il corso. Se invece hai un'azienda e vuoi portare l'AI dentro i processi, parliamone in una call.