T3 Code es una «consola de control para agentes de programación» de código abierto, publicada por el equipo pingdotgg (el equipo de Theo). No es un modelo ni un harness. Controla las herramientas que ya instalaste y en las que ya iniciaste sesión, como Claude Code, Codex, Cursor CLI y OpenCode, y les añade una interfaz de escritorio, web y móvil. El repositorio tiene licencia MIT y sumaba unas 57.000 estrellas en GitHub a 12 de noviembre de 2026. Según los conteos de búsqueda de X, las publicaciones que mencionan «T3 Code / t3code» rondaron las 800 a 1.100 diarias en los últimos 7 días.
El 12 de noviembre de 2026 (hora de Pekín, UTC+8) probamos T3 Code 0.1.9, la versión publicada en npm ese día, en una máquina Linux x64. Los clientes fueron Claude Code 2.1.319 y Codex CLI 0.167.0, ambos conectados a una API Key de AICodeWith. Todos los pasos, salidas y errores de abajo salen de esa prueba.
Respuestas rápidas
| Pregunta | Respuesta |
|---|---|
| ¿Qué es T3 Code? | Una consola única para agentes de programación (app de escritorio, web y móvil). Llama a los CLI ya instalados, como Claude Code y Codex. No ofrece modelo propio ni revende tokens. |
| ¿Cómo se instala? | Con el install.sh oficial en macOS o Linux, con install.ps1 en Windows, o con npx t3@latest para probarlo una vez. Los comandos están más abajo, en «Instalar T3 Code». |
| ¿Puedo usar una API Key de terceros en lugar de una suscripción? | Sí. T3 Code usa la configuración de cada CLI: Claude Code lee ~/.claude/settings.json y Codex lee ~/.codex/config.toml. Si los CLI funcionan por sí solos, T3 Code puede controlarlos. |
| Resultado de la prueba | T3 Code detectó Claude como «Custom API endpoint» (autenticado) y Codex como ready. Con la misma tarea (corregir un bug y añadir tests), Claude Code tardó unos 30,4 s y Codex unos 32,5 s, y todos los tests pasaron en ambos. |
| Lo que más hay que vigilar | Según la documentación, los hilos nuevos empiezan en Full access: los comandos y los cambios de archivos se ejecutan sin pedir confirmación. Antes de usarlo en un repositorio real, cambia el valor por defecto a Supervised o Auto. |
Qué es T3 Code
Según las FAQ oficiales de T3 Code, el harness es la capa que convierte un LLM en agente: le da herramientas al modelo, las ejecuta y devuelve los resultados. Claude Code y Codex están en esa capa. T3 Code no: usa esos harness y no funciona sin ellos. La analogía de las FAQ: el LLM es el chef, el harness la cocina y T3 Code el restaurante al que llevas tu propia cocina.
Sus argumentos principales, según el sitio oficial y el README de GitHub:
- Trae tu propia suscripción: inicias sesión con Claude Code, Codex, Cursor, Grok Build, OpenCode, Antigravity y otras herramientas que ya usas. T3 Code no revende tokens.
- Varios agentes en un mismo sitio: cada hilo puede usar un proveedor y un modelo distintos. Los hilos escriben en su propia rama, y un botón hace commit, push y abre el PR.
- Remoto y móvil: ejecuta
t3 upen cualquier máquina y conéctate desde la app móvil o un navegador. - Código abierto completo: licencia MIT, así que puedes hacer fork, modificarlo y alojarlo tú mismo.
Si ya alternas entre Claude Code y Codex, mira Cómo pasar una sesión de Claude Code a Codex. T3 Code reúne ese cambio en una sola interfaz.
Instalar T3 Code
Las opciones oficiales, según install.md:
# macOS / Linux: instala el comando t3 en ~/.local/bin
curl -fsSL https://t3.codes/install.sh | sh
# Probarlo una vez sin instalar (requiere Node.js)
npx t3@latest
# Windows PowerShell
irm https://t3.codes/install.ps1 | iex
La app de escritorio está en GitHub Releases o se instala con un gestor de paquetes: winget install T3Tools.T3Code en Windows, brew install --cask t3-code en macOS y yay -S t3code-bin en Arch.
Los comandos que más usarás:
| Tarea | Comando |
|---|---|
| Iniciar el servidor y abrir la app web | t3 |
| Iniciar el servidor sin navegador (servidores, SSH) | t3 serve |
| Conectarte desde el móvil u otros dispositivos | t3 up |
| Dejarlo en segundo plano | t3 service install |
| Actualizar | t3 update |
| Crear hilos, enviar mensajes y leer resultados desde la terminal | t3 thread start / send / show |
Lo arrancamos con npx -y t3@0.1.9 serve --no-browser. Unos 20 segundos después (incluida la primera descarga de npx) mostró T3 Code server is ready. y Connection string: http://localhost:3773, además de un token de emparejamiento y un código QR para la app móvil.
Paso 1: haz que Claude Code y Codex funcionen por sí solos
La documentación lo deja claro: instala al menos un proveedor e inicia sesión antes de abrir un hilo. Con suscripción, ejecuta claude auth login y codex login. Con una API Key de terceros, escribe la configuración global de cada CLI y T3 Code la usará.
Claude Code: archivo global ~/.claude/settings.json (guía completa en Configurar una API de terceros en Claude Code):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "tu API Key de AICodeWith"
}
}
Codex: archivo global ~/.codex/config.toml (instalación en la guía de instalación de Codex, campos en la guía de config.toml de Codex):
model_provider = "aicodewith"
model = "gpt-6.1-sol"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "tu API Key de AICodeWith"
Comprueba primero cada uno en una terminal. Los dos deberían responder:
claude -p "Reply with exactly: pong"
codex exec --skip-git-repo-check "Reply with exactly: pong"
En nuestra prueba, ambos devolvieron pong: unos 3,0 s Claude Code y 3,7 s Codex. Si este paso falla, T3 Code también fallará, así que empieza siempre a diagnosticar aquí.
Paso 2: revisa el estado de los proveedores en T3 Code
Al ejecutar t3 o t3 serve, T3 Code detecta los CLI que hay en el PATH. En Settings → Providers de la app web ves el estado de cada proveedor. Esto es lo que detectó en nuestra prueba:
| Proveedor | Versión | Estado | Autenticación | Algunos modelos detectados |
|---|---|---|---|---|
| Claude (id de instancia claudeAgent) | 2.1.319 | ready | authenticated, tipo customEndpoint (Custom API endpoint) | claude-opus-5-5, claude-sonnet-5-5, claude-fable-5-2 y otros |
| Codex (id de instancia codex) | 0.167.0 | ready | unknown (normal: una API Key no pasa por el inicio de sesión de ChatGPT) | gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol y otros |
Es decir, T3 Code reconoció que Claude Code usa un endpoint de API personalizado, y las listas de modelos salen del servicio que configuraste.
Además de la configuración global, T3 Code admite varias instancias, algo útil cuando una misma máquina usa suscripción y API Key a la vez:
- Añade otra instancia de proveedor en Settings → Providers. Según la documentación, cada instancia puede tener sus propias variables de entorno, como API Keys o una base URL personalizada. Marca los secretos como sensitive; tras guardarlos, T3 Code no vuelve a mostrar su valor.
- En Claude, cada instancia puede apuntar a su propio
CLAUDE_CONFIG_DIR. Por ejemplo, deja el directorio por defecto para la cuenta con suscripción y crea~/.claude_apipara la configuración con API Key. Los hilos de directorios de configuración distintos quedan aislados. - Si T3 Code no encuentra un CLI (pasa a menudo con nvm o mise), indica Binary path en los ajustes del proveedor.
Paso 3: ejecuta una tarea real en un hilo
En la app web, pulsa New thread y elige proveedor y modelo. En un servidor sin navegador, usa el CLI t3 thread, como hicimos nosotros:
cd your-project
t3 project add .
t3 thread start . "calc.py has a bug in add(). Fix it, add test_calc.py using unittest, run the tests and report the result." \
--provider claudeAgent --model claude-opus-5-5 --wait
--wait espera a que el agente termine y luego imprime su respuesta. Para Codex, usa --provider codex --model gpt-6.1-sol. El proyecto de prueba era un solo archivo, con add escrito a propósito como return a-b.
| Ruta | Tiempo real | Resultado |
|---|---|---|
| T3 Code → Claude Code (claude-opus-5-5) | unos 30,4 s | Lo cambió a return a+b, añadió 6 casos de unittest, Ran 6 tests ... OK |
| T3 Code → Codex (gpt-6.1-sol) | unos 32,5 s | Lo cambió a a + b, añadió 5 casos, los 5 pasaron (OK). Después volvimos a ejecutar python3 -m unittest test_calc en la misma carpeta y seguía en OK |
En su respuesta, Claude Code contó que sus dos primeros intentos de escribir el archivo de tests perdieron la sangría (IndentationError) y que el tercero, generado con un script, funcionó. Lee el resumen del agente, pero fíate de los tests que vuelves a ejecutar tú.
El permiso por defecto es Full access: cámbialo primero
Es el punto más importante de nuestra prueba. Según la documentación oficial de Permission modes, los hilos nuevos empiezan en Full access, sin pedir confirmación para comandos ni cambios. En la lista de procesos vimos que T3 Code lanzaba Claude Code con --permission-mode=bypassPermissions.
Cambia el valor por defecto en Settings → Threads → New threads → Permissions:
| Modo | Comportamiento |
|---|---|
| Supervised | Pide aprobación antes de comandos y cambios de archivos |
| Auto-accept edits | Aprueba automáticamente los cambios de archivos; otras acciones pueden seguir pidiendo aprobación |
| Auto | Usa la revisión automática del proveedor para acciones rutinarias y pregunta por el resto |
| Full access | Nunca pregunta |
En repositorios reales, usa como mínimo Supervised o Auto. Los equipos pueden limitar los modos disponibles en una máquina con una managed policy.
Errores comunes y soluciones
| Error / síntoma | Causa | Solución |
|---|---|---|
| No T3 Code project matches '.'. Pass a project id or a path inside a project. | La carpeta aún no es un proyecto de T3 Code (nos pasó) | Ejecuta antes t3 project add ., o arranca el servidor con --auto-bootstrap-project-from-cwd |
| Provider instance "claude" is disabled for project ... | --provider no es el id de instancia. Con claude salió este error; con claudeAgent funcionó | Usa el id de instancia que aparece en Settings → Providers y comprueba que el proveedor esté activado |
| El proveedor aparece como no instalado / no encontrado | El CLI no está en el PATH del proceso del servidor (habitual con nvm o mise) | Indica Binary path en los ajustes del proveedor o instala el CLI de forma global |
| 401 / fallo de autenticación en un hilo | Key incorrecta o caducada, o un error de configuración | Ejecuta primero claude -p / codex exec en una terminal y revisa Key, base_url e inicio de sesión paso a paso con la guía de Codex 401. Vuelve a T3 Code cuando la terminal funcione |
| 429 Too Many Requests | Límite de velocidad o ventana de uso | Espera o reduce la concurrencia según indique la respuesta del servidor; consulta Cómo resolver Codex 429 |
| t3 dice que ya hay un servidor en marcha | Un servidor por directorio de datos | Conéctate al servidor en marcha, o usa otro --base-dir para uno independiente |
| El móvil o una red externa no conecta | Problemas del enlace remoto (comentario de usuario de @TheElricLi: fuera de casa no conectaban ni el móvil ni el iPad) | La documentación remite a la página de diagnóstico de T3 Connect, o a Tailscale para un enlace propio |
Para el diagnóstico completo de 401 y 429, consulta Cómo resolver Codex 401 Unauthorized y Cómo resolver Codex 429 Too Many Requests. El comentario sobre la conexión remota procede de esta publicación de @TheElricLi.
FAQ
¿T3 Code puede usar mi suscripción de Claude Code?
Sí, según las FAQ oficiales. Controla el Claude Code en el que ya iniciaste sesión, y tu suscripción funciona como siempre. Las FAQ también afirman que T3 Code cumple los términos de servicio de Claude Code, Codex y Google Antigravity; es la postura de la propia T3 Code.
¿Tengo que introducir la API Key de terceros aparte en T3 Code?
No. Basta con la configuración global de los CLI; así funcionó nuestra prueba. Para que suscripción y API Key convivan, usa instancias de proveedor o carpetas CLAUDE_CONFIG_DIR separadas.
¿En qué se diferencia de la app de escritorio de Codex o de Claude Desktop?
Cada una de ellas sirve solo al agente de un proveedor. T3 Code reúne agentes de varios proveedores en una interfaz y añade acceso remoto y app móvil. A cambio, tienes un proceso de servidor más que mantener.
¿Funciona en un servidor sin interfaz gráfica?
Sí. Arráncalo con t3 serve y usa el CLI t3 thread, o conéctate desde otro dispositivo con t3 up o un enlace de emparejamiento.



