Respuesta rápida: controlar tu teléfono con Claude Code es gratis con Pinky, una aplicación de escritorio de código abierto (Apache-2.0, sin cuenta) que expone un iPhone o Android real a Claude Code como un servidor MCP. Instala Pinky, conecta el teléfono, activa la depuración USB (Android) o el Modo desarrollador (iPhone), añade Pinky a Claude Code con un solo comando y pídele que haga algo en el teléfono. Los toques riesgosos esperan tu clic.
Las herramientas cuestan $0. Claude Code en sí no: en claude.com/pricing (verificado el 2026-11-09), Claude Code aparece como "No" en el plan Free y está incluido en todos los planes de pago, con Pro a $17 al mes facturado anualmente o $20 mensual. Si ya pagas por Claude, darle tu teléfono no añade ningún costo. Si no, nuestra guía sobre usar Claude Code gratis cubre las opciones que existen.
A continuación: Pinky de principio a fin, y luego una comparación con Poki, una alternativa solo para iPhone.
Qué significa dejar que Claude Code controle tu teléfono
Dejar que Claude Code controle tu teléfono significa conectar un servidor MCP que convierte las acciones del teléfono en herramientas que el agente puede invocar: leer la pantalla, tocar, escribir, deslizar, abrir una app. El agente planifica cada paso, el servidor lo ejecuta en el dispositivo real por USB o Wi-Fi, y tú lo observas en una ventana espejo en tu computadora.
Eso es lo inverso a enviar instrucciones desde tu teléfono a una sesión en la laptop, algo que cubrimos en 3 formas de usar Claude Code en el móvil.
Dos proyectos hicieron esto práctico a principios de noviembre de 2026:
- Pinky, de DIYgod: iPhone y Android, aplicación de escritorio para macOS, Windows y Linux, 1,183 estrellas en GitHub al 2026-11-09.
- Poki, de Joseph Zhou: solo iPhone, un servidor MCP local más su propio agente, 636 estrellas el mismo día.
Ambos hablan el Model Context Protocol, así que cualquier cliente MCP puede usarlos.
Lo que necesitas antes de empezar
Requisitos de Pinky, según su README al 2026-11-09:
| Parte | Requisito |
|---|---|
| Mac | macOS 13 o posterior, Apple silicon o Intel |
| Windows | Windows 10 u 11, 64 bits |
| Linux | Ubuntu 20.04, Debian 11 o más reciente de 64 bits (glibc 2.29+), GTK 3 |
| Teléfono Android | Android 10 a 17 y un cable USB |
| iPhone o iPad | iOS 17.4 o posterior, un cable USB para la configuración (después funciona por Wi-Fi) |
| iOS 17.4 a 26 | Una app auxiliar WebDriverAgent, compilada una vez desde Xcode con tu Apple ID |
| Agente | Claude Code, Claude Desktop, Codex, Cursor o cualquier cliente MCP |
En iOS 27 y posteriores no se instala nada en el teléfono: Pinky monta la imagen de disco de desarrollador de Apple, que viene con Xcode (una descarga gratuita). En iOS 17.4 a 26, un auxiliar firmado con un Apple ID gratuito caduca cada 7 días, y Pinky te lo recuerda dos días antes.
Pinky se autodenomina pre-alfa. Su README indica que Claude Code ha usado un teléfono Android por USB y un iPhone con iOS 27 de principio a fin; los iPhone con versiones anteriores a iOS 27 aún no se han probado en hardware real.
Cómo configurar Pinky con Claude Code, paso a paso
Paso 1: Instalar Pinky
Descarga la compilación para tu sistema desde la última versión (v2026.1109.13 al 2026-11-09). En Mac, pinky-<version>-arm64.dmg es para Apple silicon y amd64.dmg para Intel. Los usuarios de Homebrew pueden ejecutar:
brew install --cask diygod/tap/pinky
En Windows, ejecuta pinky-setup-<version>-amd64.exe. Aún no está firmado, así que SmartScreen puede advertirte: elige Más información y luego Ejecutar de todas formas. En Debian o Ubuntu, instala el .deb con apt. La descarga pesa entre 16 y 22 MB.
Paso 2: Conectar un teléfono Android
- Abre Ajustes › Acerca del teléfono y toca Número de compilación 7 veces para desbloquear las Opciones de desarrollador.
- Activa la Depuración USB en Ajustes › Sistema › Opciones de desarrollador.
- Conecta el teléfono y toca Permitir cuando pregunte sobre la depuración USB.
- En Pinky, elige Add phone › Android y acepta Pinky Companion, que lee la pantalla en unos 70 ms en lugar de 2 s.
Pinky incluye su propio adb, así que no necesitas Android Studio. En Android 11 y posteriores puedes emparejar por Wi-Fi en lugar del cable.
Paso 3: O conectar un iPhone
- Conecta el iPhone, desbloquéalo, toca Confiar e ingresa el código de acceso.
- Activa el Modo desarrollador en Ajustes › Privacidad y seguridad. El teléfono se reinicia; toca Activar.
- En Mac, instala Xcode una vez y ábrelo, para que Pinky pueda usar su imagen de disco de desarrollador. Pinky entonces mostrará el teléfono como listo.
- En iOS 17.4 a 26, instala el auxiliar WebDriverAgent desde Xcode. Sin él, Pinky puede mostrar y leer la pantalla, pero no puede tocar, deslizar ni escribir.
Paso 4: Añadir Pinky a Claude Code
Haz clic en Settings › Agents › Connect junto a Claude Code, y Pinky se registra e instala su guía de agente como una skill. A mano, es una sola línea:
claude mcp add --scope user pinky -- pinkyctl mcp
El comando es pinkyctl porque muchos sistemas ya tienen un programa llamado pinky. La documentación de MCP de Claude Code explica los scopes.
Paso 5: Darle una tarea a Claude Code
Inicia Claude Code y pide algo en lenguaje natural:
Open Messages on my phone and tell Sam I'm running late.
La primera vez, Pinky pregunta si permitir el nuevo agente y qué puede hacer. Claude Code entonces invoca herramientas como phone_connect, phone_observe, phone_tap y phone_type. Cuando un paso te necesita, la llamada devuelve approval_pending y no sucede nada hasta que haces clic en Allow. No responder en 60 segundos cuenta como rechazo.
¿No tienes un teléfono a mano? Relanza Pinky con --fake para obtener dos teléfonos de demostración con guiones predefinidos.
Cómo Pinky mantiene al agente bajo control
Las reglas de seguridad viven en la puerta de enlace de Pinky, entre el agente y el teléfono, no en el prompt, así que el texto en pantalla no puede convencer al agente de aprobarse a sí mismo. Activado por defecto:
- Pagos, operaciones bursátiles y transferencias esperan tu clic. Settings › Safety puede añadir envíos, eliminaciones, instalaciones o todos los pasos.
- Las apps de banca, billetera y gestores de contraseñas son invisibles, y los agentes no pueden escribir en campos de contraseña ni de códigos de un solo uso.
- Puedes tomar el control en cualquier momento. Haz clic en el espejo y el agente se pausa.
- Cada ejecución se registra con pasos, capturas de pantalla y una grabación de pantalla, todo guardado en tu computadora.
Una advertencia de la propia FAQ de Pinky: un agente que pueda ejecutar comandos de shell podría llegar a un teléfono Android a través de adb y saltarse la puerta de enlace. Si eso te preocupa, pon el agente en un sandbox y conéctalo a Pinky por HTTP.
Pinky vs Poki: cuál opción gratuita te conviene
| Pinky | Poki | |
|---|---|---|
| Licencia | Apache-2.0 | AGPL-3.0 |
| Teléfonos | iPhone (iOS 17.4+) y Android 10 a 17 | Solo iPhone (iOS 18+ para la vía de la app Poki) |
| Computadora | macOS 13+, Windows, Linux | macOS (14+ para configurar, 15+ para el servidor MCP); ports comunitarios para Linux y Windows |
| Instalaciones extra | Xcode para la imagen de disco en Mac; auxiliar en iOS 17.4 a 26 | Xcode completo, Rust, Node.js 24+ y ffmpeg para el servidor MCP |
| Cuenta Apple | Una cuenta gratuita funciona; el auxiliar se refirma cada 7 días | Una cuenta gratuita funciona; la firma dura 7 días |
| Aprobaciones | Aplicadas por la puerta de enlace, fuera del agente | El README advierte que enviará mensajes o pagará si se lo pides |
| Agente propio | No, tu agente hace el razonamiento | Sí, Poki Agent (usa GPT-6.1 Terra por defecto), además de canales por iMessage y Telegram |
Elige Pinky si tienes un teléfono Android, trabajas en Windows o Linux, o quieres aprobaciones que no dependan del agente.
Elige Poki si estás en un Mac con Xcode y quieres un agente para iPhone al que puedas escribir desde Telegram o iMessage. Su inicio rápido está guiado por el agente: le pides a Claude Code que instale Poki desde su repositorio, y se detiene cuando iOS te necesita. La vía de la app también requiere una app de VPN o proxy en el iPhone, como Karing o Shadowrocket, que enrute 10.7.0.1 de vuelta al Mac [VERIFICAR: si esa app es gratuita en el App Store en tu región].
El README de Poki indica que los iPhone físicos están verificados solo en orientación vertical por ahora. Ambos proyectos tienen días de vida, así que espera cambios incompatibles. Para emuladores y dispositivos de prueba, consulta nuestra guía del servidor MCP Mobile Next.
Deja que Claude Code verifique las APIs detrás de cada pantalla con Apidog CLI
Cada pantalla por la que tu agente navega llama a un backend: un inicio de sesión, un carrito, un pedido. Cuando una pantalla muestra algo incorrecto, necesitas saber si se rompió la UI o la API. Tu agente puede responderlo con Apidog CLI mientras Pinky se encarga del teléfono.
Configúralo una vez:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Luego dale a Claude Code un solo prompt:
Import ./openapi.json into Apidog project <projectId>. Create a test case for
POST /auth/login, GET /cart and POST /orders that checks status codes and the
fields each screen shows. Then use Pinky to log in on my phone, add one item
and place a test order. After each screen, run the matching Apidog test case
against the staging environment and tell me whether the app or the API failed.
El agente importa la especificación, valida sus payloads y crea los casos antes de tocar el teléfono:
apidog import --project <projectId> --format openapi --file ./openapi.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file login-case.json
apidog test-case create --project <projectId> --file login-case.json
apidog test-case list --project <projectId>
Tras cada paso en el teléfono, ejecuta el caso de esa pantalla y lee el resultado:
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
Añade --upload-report para ver la ejecución en la app de Apidog. El mismo comando con -r junit entra en CI; nuestra guía de CI/CD con Apidog CLI muestra el pipeline. Para el lado del agente, consulta Apidog CLI en Claude Code. El plan Free de Apidog cubre hasta 4 usuarios.
Solución de problemas comunes de configuración
- El teléfono no aparece en la lista: abre su Checkup en el menú ··· de Pinky, que indica el interruptor que falta.
- El emparejamiento por Wi-Fi nunca termina: las redes de invitados y de oficina suelen aislar los dispositivos. Empareja con un código o usa el cable.
- Los toques en iPhone no hacen nada en iOS 26 o anterior: falta el auxiliar WebDriverAgent o su firma de 7 días caducó. Reinstálalo desde Xcode.
Preguntas frecuentes
¿De verdad es gratis dejar que Claude Code controle mi teléfono? Pinky y Poki son gratuitos y de código abierto, y una cuenta Apple gratuita funciona. Claude Code requiere un plan de pago de Claude, desde $17 al mes facturado anualmente.
¿Necesito hacer jailbreak o root a mi teléfono? No. Pinky usa la depuración USB de Android y el Modo desarrollador de Apple con la imagen de disco de desarrollador. Poki también indica que no se necesita jailbreak.
¿Pinky funciona también con Codex o Cursor? Sí. Settings › Agents conecta Claude Code, Codex, Cursor, Gemini CLI y otros, y cualquier cliente MCP puede ejecutar pinkyctl mcp.
¿La pantalla de mi teléfono va a la nube? No a través de Pinky: las grabaciones se quedan en tu computadora. Lo que el agente lee va a tu proveedor de modelos, como con cualquier herramienta.
¿Puede el agente gastar mi dinero? Con Pinky, los pagos esperan tu clic y las apps de banca están ocultas. El README de Poki advierte que pagará si se lo pides, así que mantén las tareas acotadas.