¿Qué es T3 Code y cómo se instala? Conectar Claude Code y Codex, usar una API Key de terceros y resolver errores comunes (probado en 0.1.9)

T3 Code es la consola de código abierto de pingdotgg para manejar agentes de programación. No trae modelo propio: controla los CLI de Claude Code, Codex, Cursor y otros que ya tienes instalados. Probamos T3 Code 0.1.9 en Linux. Esta guía cubre los comandos de instalación, cómo conectar Claude Code y Codex a una API Key de AICodeWith para que T3 Code los controle, una ejecución completa de ambos agentes con el comando t3 thread y los errores que encontramos, con su solución.

7 分钟阅读
¿Qué es T3 Code y cómo se instala? Conectar Claude Code y Codex, usar una API Key de terceros y resolver errores comunes (probado en 0.1.9)

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.

Create API Key →

Respuestas rápidas

PreguntaRespuesta
¿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 pruebaT3 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 vigilarSegú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 up en 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:

bash
# 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
powershell
# 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:

TareaComando
Iniciar el servidor y abrir la app webt3
Iniciar el servidor sin navegador (servidores, SSH)t3 serve
Conectarte desde el móvil u otros dispositivost3 up
Dejarlo en segundo planot3 service install
Actualizart3 update
Crear hilos, enviar mensajes y leer resultados desde la terminalt3 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):

json
{
  "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):

toml
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:

bash
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í.

Create API Key →

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:

ProveedorVersiónEstadoAutenticaciónAlgunos modelos detectados
Claude (id de instancia claudeAgent)2.1.319readyauthenticated, 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.0readyunknown (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_api para 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:

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

RutaTiempo realResultado
T3 Code → Claude Code (claude-opus-5-5)unos 30,4 sLo 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 sLo 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:

ModoComportamiento
SupervisedPide aprobación antes de comandos y cambios de archivos
Auto-accept editsAprueba automáticamente los cambios de archivos; otras acciones pueden seguir pidiendo aprobación
AutoUsa la revisión automática del proveedor para acciones rutinarias y pregunta por el resto
Full accessNunca 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íntomaCausaSolució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 encontradoEl 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 hiloKey incorrecta o caducada, o un error de configuraciónEjecuta 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 RequestsLímite de velocidad o ventana de usoEspera 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 marchaUn servidor por directorio de datosConéctate al servidor en marcha, o usa otro --base-dir para uno independiente
El móvil o una red externa no conectaProblemas 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.

Create API Key →

Fuentes

相关文章

Qué es el UI SDK y cómo se usa? La biblioteca de comportamientos de Vercel y shadcn para agentes, instalada y probada en Claude Code / Codex / Cursor (0.1.0-beta.1)

Qué es el UI SDK y cómo se usa? La biblioteca de comportamientos de Vercel y shadcn para agentes, instalada y probada en Claude Code / Codex / Cursor (0.1.0-beta.1)

El UI SDK es la biblioteca de comportamientos de Vercel para agentes, publicada el 12 de noviembre de 2026 como 0.1.0-beta.1. Los comportamientos viven en el paquete independiente del framework @ui-sdk/core y los renderizan adaptadores para React, Vue, Svelte, Solid y Web Components. Esta guía sigue la documentación oficial sobre qué es, cómo instalarlo y cómo añadir el skill para Claude Code, Codex y Cursor, y registra los comandos, tiempos y salidas de nuestra máquina de prueba.

¿Qué es AWS Emulator y cómo se instala? Prueba apps de AWS en local con Claude Code y Codex (probado en 1.0.322)

¿Qué es AWS Emulator y cómo se instala? Prueba apps de AWS en local con Claude Code y Codex (probado en 1.0.322)

AWS Emulator es el emulador local oficial de las API de AWS, con disponibilidad general desde el 11 de noviembre de 2026 (hora de EE. UU.). No tiene cargo adicional por el servicio, su código es abierto, no necesita cuenta de AWS y cubre más de 200 servicios. Probamos la versión 1.0.322 en Debian 13: comandos de instalación, AWS CLI apuntando al endpoint local para crear un bucket de S3 y una tabla de DynamoDB, los errores que encontramos y cómo hacer que Claude Code, Codex y Cursor escriban y prueben código contra el emulador.

Claude Code / Codex / Cursor Agent Hooks: configuración comparada, PreToolUse, script mínimo y prueba de fail-open

Claude Code / Codex / Cursor Agent Hooks: configuración comparada, PreToolUse, script mínimo y prueba de fail-open

Las instrucciones, AGENTS.md y los skills son sugerencias que el modelo puede ignorar; los hooks son scripts deterministas que el harness ejecuta en momentos fijos. Este artículo compara las rutas de configuración, nombres de eventos, exit 2 / deny, fail-open y fail-closed de Claude Code, Codex y Cursor para PreToolUse (o su equivalente), e incluye un script mínimo de intercepción probado en Claude Code.