Herramientas de desarrollo

Tutorial de Windows T3 Code: use su teléfono móvil para controlar remotamente Codex, Claude Code y OpenCode

Instale T3 Code en Windows para controlar Codex, Claude Code, Cursor y OpenCode nativos desde la web, el escritorio y el dispositivo móvil, y manejar la autenticación, el acceso remoto, los firewalls, la sincronización de sesiones y los riesgos de seguridad.

T3 Code se define a sí mismo como una “superficie de control de arnés del agente”: no proporciona un nuevo modelo base, pero controla Codex, Claude Code, Cursor, Grok Build y OpenCode que ya están instalados y registrados en su computadora.

Puede ver y controlar el Agente mediante una página web local, el cliente de escritorio Electron o la interfaz móvil. Resuelve el problema de seguir viendo tareas, respondiendo preguntas y administrando múltiples agentes de codificación locales después de abandonar la computadora. Esto también significa que el límite superior de permisos del código T3 depende de la CLI subyacente. Si Codex puede modificar todo el espacio de trabajo y Claude Code puede ejecutar comandos, entonces la interfaz de control remoto también puede activar estas capacidades. El funcionario indicó claramente que el proyecto aún se encuentra en sus primeras etapas y que se deben esperar errores, por lo que este artículo comienza con una prueba local y luego analiza el acceso remoto.

¿Cuál es la diferencia entre este y el Escritorio remoto y Pi Web?

El escritorio remoto transmite toda la interfaz gráfica de Windows, mientras que T3 Code solo presenta la sesión del Agente y los controles relacionados, por lo que es más fácil de operar en el teléfono móvil. No se trata de mover el modelo a la nube. La CLI del agente, el estado de inicio de sesión, los repositorios y los comandos aún se están ejecutando en su computadora con Windows. En comparación con el paquete web de un solo Agente, el objetivo del Código T3 es controlar de manera uniforme múltiples proveedores y proporcionar portales web, de escritorio y móviles.

Uso adecuado:

  • Compruebe los resultados de las pruebas a largo plazo durante los desplazamientos;
  • Responda las preguntas aclaratorias del agente en su teléfono móvil;
  • Administre varias sesiones de repositorio independientes al mismo tiempo;
  • Controle el host de desarrollo desde una tableta dentro de la LAN;
  • Conserve su inicio de sesión de suscripción actual de Codex o Claude Code. No es adecuado abrir computadoras desatendidas directamente a la red pública, ni debe considerarse como una plataforma de permisos empresariales madura.

Verifique el Agente subyacente antes de la instalación

El Código T3 requiere al menos un Proveedor instalado y certificado. Verifique elemento por elemento en PowerShell:

1
2
3
4

codex --version
claude --version
cursor-agent --version
opencode --version

Solo uno de ellos debe estar disponible, no es necesario instalar todos. Inicio de sesión Codex:

1

codex login

Inicio de sesión Claude Code:

1

claude auth login

Inicio de sesión CLI con cursor:

1

cursor-agent login

Inicio de sesión OpenCode:

1

opencode auth login

Estos comandos pueden cambiar con cada versión del proyecto, y prevalecerán los documentos oficiales correspondientes. Después de completar el inicio de sesión, primero abra un repositorio de prueba en una terminal normal para confirmar que el Agente puede iniciar y leer archivos.

Ruta 1: Prueba de instalación cero con npx

La entrada oficial más rápida es:

1

npx t3@latest

La primera ejecución descargará el paquete npm e iniciará el backend de T3 Code y la aplicación web local. Tenga en cuenta la dirección local y el puerto que muestra el terminal; no asuma que es un puerto determinado según tutoriales antiguos. Ver todos los parámetros:

1

npx t3@latest --help

Si npm pregunta si desea instalar el paquete, primero verifique que el nombre del paquete sea t3 y confirme que la fuente proviene del proyecto oficial. Mantenga el terminal en funcionamiento y acceda a la URL local que genera en un navegador en la misma computadora. No configure el reenvío de red pública en este momento. Primero complete la verificación de la función local. Presione Ctrl+C en el terminal para finalizar la prueba. Luego confirme si el proceso salió:

1

Get-Process | Where-Object { $_.ProcessName -match 't3|node' }

No finalice todos los procesos de Node a voluntad, porque otros servicios de desarrollo también pueden usar Node.

Ruta 2: Instalar la versión de escritorio de Windows

Admite oficialmente la instalación a través de Winget:

1

winget install T3Tools.T3Code

Inicie desde el menú Inicio después de la instalación o verifique si el programa está registrado:

1

winget list T3Tools.T3Code

Actualización:

1

winget upgrade T3Tools.T3Code

Si la política empresarial bloquea Winget, usted Puede descargarlo desde las versiones oficiales de GitHub. Descargue el paquete de instalación firmado. No obtenga instaladores reempaquetados de sitios de descarga de software de terceros.

La versión de escritorio aún depende del proveedor local. No completa automáticamente el inicio de sesión de Codex o Claude Code.

Conectarse al repositorio de prueba por primera vez

Cree un nuevo directorio que no contenga código confidencial:

1
2
3
4

$testRoot = 'C:\Work\t3code-demo'
New-Item -ItemType Directory -Path $testRoot -Force
Set-Location $testRoot
git init

Después de crear algunos archivos de muestra, seleccione este directorio del Código T3 e inicie el proveedor conectado. La primera tarea debe ser de solo lectura, por ejemplo:

1

列出仓库中的文件，说明每个文件用途，不要修改文件，也不要运行安装命令。

Compruebe si la interfaz se muestra correctamente:

  • Nombre del proveedor;
  • Directorio de trabajo actual;
  • Salida del agente;
  • Llamada o aprobación de la herramienta;
  • Botón para detener la sesión;
  • Estado de la sesión después de actualizar la página.

Después de pasar, deje que el Agente modifique un archivo de prueba y use Git para confirmar el alcance:

1
2

git status --short
git diff

Por qué las variables de identidad y entorno de Windows son inconsistentes

Cuando npx t3@latest se inicia desde PowerShell, generalmente hereda el usuario, PATH y las variables de entorno del terminal actual. Las aplicaciones de escritorio pueden obtener un entorno diferente cuando se inician desde el menú Inicio. El síntoma típico es que codex se puede ejecutar en la terminal, pero el código T3 indica que no se puede encontrar el proveedor. Primero verifique la ubicación del comando:

1
2
3

Get-Command codex
Get-Command claude
$env:PATH -split ';'

Vuelva a iniciar sesión en Windows o reinicie la aplicación de escritorio para actualizar el nivel de usuario PATH que cambió después de la instalación. No escriba la clave API en variables de entorno a nivel del sistema para “resolver todo”. El código T3 está diseñado para reutilizar la autenticación existente del proveedor, dando prioridad a corregir el inicio de sesión CLI y la visibilidad del programa.

Si T3 Code se ejecuta como un usuario diferente de Windows, no leerá automáticamente el archivo de autenticación de su cuenta actual.

Acceso web y LAN local

Solo se puede acceder a la dirección de escucha local 127.0.0.1 desde la computadora actual, que es la opción predeterminada más segura. Para acceder desde un teléfono móvil en el mismo Wi-Fi, es necesario confirmar si T3 Code proporciona los parámetros de dirección de escucha. Eche un vistazo primero:

1

npx t3@latest --help

Cambie la dirección de escucha a la interfaz LAN solo cuando los parámetros oficiales lo admitan claramente. Luego busque la IP de la computadora:

1
2

Get-NetIPAddress -AddressFamily IPv4 |
  Where-Object { $_.IPAddress -notlike '169.254*' -and $_.IPAddress -ne '127.0.0.1' }

Vea la escucha real:

1
2
3

Get-NetTCPConnection -State Listen |
  Sort-Object LocalPort |
  Select-Object LocalAddress,LocalPort,OwningProcess

Cree reglas de Firewall de Windows solo para los puertos reales y limite las direcciones remotas al segmento de red doméstica o laboral. No cree reglas amplias que permitan todos los puertos, todos los perfiles de red. No utilice acceso HTTP simple en Wi-Fi público porque el contenido de la sesión y las solicitudes de control pueden ser interceptados por dispositivos en el mismo segmento de red.

Métodos de acceso remoto más seguros

Después de abandonar la LAN, utilice preferentemente una VPN de red, como Tailscale, WireGuard o una VPN empresarial existente. De esta manera, T3 Code puede seguir escuchando solo redes privadas. Las relaciones recomendadas son:

1

手机 -> 私有 VPN -> Windows 开发机 -> T3 Code -> 本地 Agent CLI

No recomendadas:

1

互联网 -> 路由器端口转发 -> 未认证的 T3 Code HTTP 端口

Si debe utilizar un proxy inverso, al menos requiera HTTPS, autenticación sólida, restricciones de origen, compatibilidad con WebSocket y sesiones cortas. También asegúrese de que el propio mecanismo de autenticación del Código T3 no pueda depender únicamente de una URL difícil de adivinar. El túnel de Cloudflare puede ocultar la dirección de origen, pero el túnel público sigue siendo la entrada de la red pública. Debe combinarse con la autenticación de Access, no asuma que el hecho de que “no haya puertos de enrutador abiertos” no significa que no haya riesgo.

Qué acciones se deben verificar en el teléfono móvil

No realice tareas de desarrollo reales inmediatamente después de la primera conexión del teléfono móvil. Pruebe elemento por elemento:

  1. Abra una sesión existente;
  2. Compruebe si el resultado largo está completo;
  3. Responder con texto sin formato;
  4. Rechace la aprobación de la herramienta una vez;
  5. Detenga el Agente en ejecución;
  6. Cambiar a otro repositorio;
  7. Vuelva a conectarse después de bloquear la pantalla del teléfono;
  8. Desconecte la VPN y confirme que no se puede acceder a ella. En particular, pruebe si “detener” realmente finaliza el proceso subyacente. Algunas interfaces simplemente dejan de generar resultados y es posible que el comando aún se esté ejecutando en segundo plano. Verifique los procesos relacionados en el lado de Windows:
1
2
3

Get-CimInstance Win32_Process |
  Where-Object { $_.Name -match 'codex|claude|node|t3' } |
  Select-Object ProcessId,Name,CommandLine

No confunda espacios de trabajo con múltiples sesiones de Proveedores

T3 Code puede controlar múltiples Proveedores, lo que no significa que compartan el mismo contexto, permisos o configuración. Registrar explícitamente para cada sesión:

  • Proveedor;
  • Ruta absoluta al repositorio;
  • Sucursal actual;
  • Si se permite la escritura;
  • Si se permite la ejecución del comando;
  • Objetivo de la tarea;
  • Aceptación del comando. Requerir que el Agente informe antes de la operación remota:
1

只报告当前工作目录、Git 分支和未提交文件，不要修改任何内容。

Si el directorio o rama es incorrecto, detenga la sesión y corríjala en la computadora antes de continuar. Las pantallas de los teléfonos móviles son más pequeñas, lo que facilita ignorar las indicaciones de ruta.

Suscripciones, claves API y tarifas

Descripción oficial T3 Code puede utilizar sus suscripciones o certificaciones existentes en Codex, Claude Code, Cursor, Grok Build y OpenCode.

Los cargos aún corren a cargo del Proveedor correspondiente. T3 Code es solo una superficie de control y no convertirá tareas de alto valor en tareas gratuitas. Es necesario verificar por separado:

  • Si el proveedor utiliza inicio de sesión de suscripción o clave API;
  • Si las sesiones paralelas aumentan el consumo;
  • Si las tareas en segundo plano a largo plazo aún se están ejecutando;
  • Si se repiten operaciones costosas durante reintentos fallidos;
  • Si la tarea se detendrá automáticamente cuando se desconecte el teléfono móvil. No sincronice el directorio de autenticación del proveedor con el disco de la nube pública y no pegue la clave API en el chat del Código T3.

¿Qué significa que el proyecto aún se encuentra en sus primeras etapas?

El archivo README oficial indica claramente “Se esperan errores” y actualmente no existe un sitio de documentación pública completa. Supongamos para el uso real:

  • Las actualizaciones pueden cambiar el formato de la sesión;
  • Las versiones web y de escritorio pueden comportarse de manera inconsistente;
  • Algunas integraciones de proveedores van por detrás de las nuevas versiones CLI;
  • Reconexión remota puede perder algo de estado;
  • Los procesos en segundo plano requieren inspección manual;
  • El modelo de seguridad aún puede ajustarse.

No base su entorno de desarrollo único ni su historial de sesiones único en una versión anterior. El código real siempre se guarda en Git y las descripciones de tareas importantes se guardan en Issues o documentos de repositorio.

Errores del código T3 localizados por síntomas

Error en la descarga de npx t3@latest

Verifique las versiones de registro, agente y nodo de npm:

1
2
3

npm config get registry
node --version
npm cache verify

No desactive las comprobaciones TLS corporativas ni utilice espejos que no sean de confianza sin confirmar la causa.

El código T3 no puede encontrar Codex o Claude

Ejecute Get-Command con el mismo usuario de Windows, reinicie la aplicación de escritorio y confirme que el inicio de sesión CLI no existe solo en otro usuario o WSL.

En blanco tras abrir el navegador

Comprueba el primer error al iniciar el terminal, consola del navegador y ocupación del puerto. Pruebe con una ventana del navegador sin extensiones para excluir el bloqueo de secuencias de comandos.

Se agotó el tiempo de espera de la conexión del teléfono móvil

Confirme que el teléfono móvil y la red informática sean accesibles, que el programa no esté monitoreando 127.0.0.1, que el rango de reglas del Firewall de Windows sea correcto y que se haya establecido la ruta VPN.

La sesión muestra ejecución pero no hay resultados

Compruebe si el Agente subyacente está esperando aprobación, el inicio de sesión ha caducado o el comando está bloqueado. Vuelva al lado de Windows y vea el proceso y los registros de inicio.

Se producen modificaciones inesperadas en el repositorio

Detenga el Agente inmediatamente y guarde la evidencia:

1
2
3

git status --short
git diff --stat
git diff

No utilice comandos destructivos de Git para limpiar directamente el sitio. Primero confirme qué archivos fueron modificados originalmente por el usuario.

Hábitos de seguridad para el uso diario

  • Habilitar cifrado de disco y pantalla de bloqueo en máquina de desarrollo Windows;
  • Habilitar biometría y borrado remoto en teléfono móvil;
  • T3 Code solo escucha la máquina local o VPN privada;
  • Hacer no abrir directamente el puerto de la red pública;
  • El agente utiliza usuarios normales en lugar de administradores;
  • Los comandos de alto riesgo conservan la aprobación manual;
  • Confirma el directorio y la rama para cada tarea remota;
  • Actualiza el código T3 y el proveedor subyacente con regularidad;
  • Guarde el estado de Git antes de abandonar la computadora;
  • Revoque las sesiones de VPN y de proveedor si falta el dispositivo.

Vale la pena instalarlo

Si ejecuta con frecuencia tareas de Codex o Claude Code que duran más de diez minutos, la entrada de control móvil de T3 Code es muy atractiva. La forma más rápida de evaluar no es implementar inmediatamente en la red pública, sino ejecutar npx t3@latest en el repositorio de prueba para experimentar la Web local, la detención de tareas y la recuperación de sesiones.

Después de confirmar que el área local es confiable, acceda al teléfono móvil a través de una VPN privada. Solo cuando se verifican la autenticación, los permisos, los registros y el comportamiento de desconexión se le debe permitir tomar el control del repositorio de trabajo real.

Recursos de T3 Code