# ARTEMIS: Claude Code usa il tuo telefono Android

Guida di Riccardo Belli, dati letti il 2 novembre 2026.
Pagina: https://www.riccardobelli.com/artemis/
Repo: https://github.com/google/artemis (16.223 stelle, licenza Apache 2.0)

## Cinque cose da sapere prima

1. Solo Android. iPhone è nella lista delle cose da fare del progetto, senza una data. Va bene anche l'emulatore Android sul computer.
2. Serve ADB con il Debug USB acceso sul telefono. ADB lo installa lo script di avvio.
3. Sul telefono si installa l'Artemis Accessibility Helper, un servizio di accessibilità che legge lo schermo (notifica fissa più una voce in Impostazioni › Accessibilità). Il file di configurazione dice di spegnere l'installazione automatica sui telefoni personali o condivisi.
4. Meglio un telefono di prova o l'emulatore: un agente che tocca lo schermo può aprire la chat sbagliata o confermare un acquisto.
5. Il codice è gratis. La chiave API del modello (Gemini, OpenAI, Anthropic, OpenRouter o xAI) si paga a consumo, anche quando lo comandi da Claude Code.

## Il risultato dichiarato

AndroidWorld (Google Research): 99,1% di compiti riusciti al primo tentativo (pass@1) su 116 compiti in più di 20 app. Una persona nello stesso grafico arriva all'80%. Dato pubblicato da loro nel README.

Due modi di lavoro: Flash (3-5 secondi a passo, compiti semplici) e Pro (piano, controllo prima di ogni azione e verifica finale, 15-40 secondi a passo).

## Installazione

Sul telefono:
1. Impostazioni › Informazioni sul telefono › tocca 7 volte Numero build.
2. Impostazioni › Sistema › Opzioni sviluppatore › Debug USB acceso.
3. Collega il cavo e accetta la richiesta di fidarti del computer.

Sul computer (Python 3.12 o più recente; lo script installa ADB, scrcpy, FFmpeg e le dipendenze con uv).

Mac e Linux:

```
git clone https://github.com/google/artemis.git && cd artemis
./start.sh
```

Windows (PowerShell):

```
git clone https://github.com/google/artemis.git
cd artemis
.\start.bat
```

La chiave del modello:

```
cp .env.example .env
```

Nel file .env riempi una riga, per esempio GEMINI_API_KEY= oppure ANTHROPIC_API_KEY=.

Se usi il tuo telefono personale, nello stesso file:

```
ARTEMIS_HELPER_AUTO_INSTALL=false
ARTEMIS_KEEP_DEVICE_AWAKE=false
```

L'app di servizio la installi a mano con `uv run artemis helper install` e la togli con `uv run artemis helper uninstall`.

Prima prova:

```
uv run artemis run "Apri Impostazioni, vai su Batteria e dimmi la percentuale attuale" --profile flash
```

Console nel browser: http://localhost:8000

## Collegarlo a Claude Code

```
uv run artemis mcp --install claude
```

Installa il server MCP e le regole in ~/.claude/rules/artemis.md. Con --install all lo collega anche a Codex, Cursor, Windsurf, VS Code e altri. Riapri Claude Code e controlla con /mcp.

### Prompt 1: un'automazione

```
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.
```

### Prompt 2: il test di un'app

```
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 [test@esempio.it] 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.
```

### Prompt 3: se qualcosa non va

```
ARTEMIS non funziona. Usa mobile_diagnose, dimmi cosa non va e sistema tu quello che si può sistemare dal computer.
```
