T3 Code, c'est quoi et comment l'installer ? Connecter Claude Code et Codex, utiliser une clé API tierce, corriger les erreurs courantes (testé sur 0.1.9)

T3 Code est la console open source de pingdotgg pour piloter des agents de code. Elle n'embarque aucun modèle et pilote les CLI Claude Code, Codex, Cursor et autres déjà installés sur votre machine. Nous avons testé T3 Code 0.1.9 sous Linux. Ce guide couvre les commandes d'installation, la configuration de Claude Code et de Codex avec une clé API AICodeWith pour que T3 Code les pilote, un essai complet des deux agents avec la commande t3 thread, puis les erreurs rencontrées et leurs solutions.

7 分钟阅读
T3 Code, c'est quoi et comment l'installer ? Connecter Claude Code et Codex, utiliser une clé API tierce, corriger les erreurs courantes (testé sur 0.1.9)

T3 Code est une « console de pilotage pour agents de code » open source, publiée par l'équipe pingdotgg (l'équipe de Theo). Ce n'est ni un modèle ni un harness. Elle pilote les outils déjà installés et connectés sur votre machine (Claude Code, Codex, Cursor CLI, OpenCode, etc.) et leur ajoute une interface de bureau, web et mobile. Le dépôt est sous licence MIT et comptait environ 57 000 étoiles GitHub au 12 novembre 2026. D'après le comptage de recherche de X, les posts mentionnant « T3 Code / t3code » tournaient autour de 800 à 1 100 par jour sur les 7 derniers jours.

Le 12 novembre 2026 (heure de Pékin, UTC+8), nous avons testé T3 Code 0.1.9, la version publiée sur npm ce jour-là, sur une machine Linux x64. Les clients étaient Claude Code 2.1.319 et Codex CLI 0.167.0, tous deux connectés à une clé API AICodeWith. Toutes les étapes, sorties et erreurs ci-dessous viennent de cet essai.

Create API Key →

Réponses rapides

QuestionRéponse
Qu'est-ce que T3 Code ?Une console unique pour agents de code (application de bureau, web et mobile). Elle pilote les CLI Claude Code, Codex, etc. déjà installés. Elle ne fournit aucun modèle et ne revend pas de tokens.
Comment l'installer ?Avec le script officiel install.sh sous macOS ou Linux, install.ps1 sous Windows, ou npx t3@latest pour un essai ponctuel. Les commandes sont dans la section « Installer T3 Code ».
Peut-on utiliser une clé API tierce au lieu d'un abonnement ?Oui. T3 Code reprend la configuration de chaque CLI : Claude Code lit ~/.claude/settings.json et Codex lit ~/.codex/config.toml. Si les CLI fonctionnent seules, T3 Code peut les piloter.
Résultat du testT3 Code a détecté Claude en « Custom API endpoint » (authentifié) et Codex à l'état ready. Même tâche des deux côtés (corriger un bug et ajouter des tests) : environ 30,4 s côté Claude Code, 32,5 s côté Codex, tous les tests réussis.
Le point à surveillerLa documentation indique que les nouveaux fils démarrent en Full access : commandes et modifications de fichiers s'exécutent sans confirmation. Avant de l'utiliser sur un vrai dépôt, passez la valeur par défaut à Supervised ou Auto.

Ce qu'est T3 Code

Selon la FAQ officielle de T3 Code, le harness est la couche qui transforme un LLM en agent : il donne des outils au modèle, les exécute et renvoie les résultats. Claude Code et Codex sont à ce niveau. T3 Code non : elle utilise ces harness et ne fonctionne pas sans eux. L'analogie de la FAQ : le LLM est le chef, le harness la cuisine, et T3 Code le restaurant où l'on apporte sa propre cuisine.

Principaux arguments, selon le site officiel et le README GitHub :

  • Votre propre abonnement : connexion avec Claude Code, Codex, Cursor, Grok Build, OpenCode, Antigravity et les autres outils que vous utilisez déjà. T3 Code ne revend pas de tokens.
  • Plusieurs agents au même endroit : chaque fil peut utiliser un fournisseur et un modèle différents. Les fils écrivent sur leur propre branche, et un bouton suffit pour commit, push et ouvrir une PR.
  • Accès distant et mobile : lancez t3 up sur n'importe quelle machine, puis connectez-vous depuis l'application mobile ou un navigateur.
  • Entièrement open source : licence MIT, donc vous pouvez forker, modifier et auto-héberger.

Si vous passez déjà d'une session Claude Code à Codex, voyez Comment passer une session Claude Code à Codex. T3 Code regroupe ce va-et-vient dans une seule interface.

Installer T3 Code

Les options officielles, d'après install.md :

bash
# macOS / Linux : installe la commande t3 dans ~/.local/bin
curl -fsSL https://t3.codes/install.sh | sh

# Essai ponctuel sans installation (Node.js requis)
npx t3@latest
powershell
# Windows PowerShell
irm https://t3.codes/install.ps1 | iex

L'application de bureau se télécharge sur GitHub Releases ou s'installe avec un gestionnaire de paquets : winget install T3Tools.T3Code sous Windows, brew install --cask t3-code sous macOS, yay -S t3code-bin sous Arch.

Les commandes les plus utiles :

ActionCommande
Démarrer le serveur et ouvrir l'application webt3
Démarrer le serveur sans navigateur (serveur, SSH)t3 serve
Se connecter depuis un téléphone ou un autre appareilt3 up
Lancer en arrière-plant3 service install
Mettre à jourt3 update
Ouvrir un fil, envoyer un message, lire le résultat en ligne de commandet3 thread start / send / show

Nous l'avons lancé avec npx -y t3@0.1.9 serve --no-browser. Environ 20 secondes plus tard (premier téléchargement npx compris), il a affiché T3 Code server is ready. et Connection string: http://localhost:3773, ainsi qu'un jeton d'appairage et un QR code pour l'application mobile.

Étape 1 : faire fonctionner Claude Code et Codex seuls

La documentation pose la condition clairement : installez au moins un fournisseur et connectez-vous avant d'ouvrir un fil. Avec un abonnement, lancez claude auth login et codex login. Avec une clé API tierce, écrivez la configuration globale de chaque CLI et T3 Code s'en servira.

Claude Code : fichier global ~/.claude/settings.json (guide complet dans Configurer une API tierce pour Claude Code) :

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "votre clé API AICodeWith"
  }
}

Codex : fichier global ~/.codex/config.toml (installation dans le guide d'installation de Codex, détail des champs dans le guide 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 = "votre clé API AICodeWith"

Vérifiez d'abord chaque outil dans un terminal. Les deux doivent répondre :

bash
claude -p "Reply with exactly: pong"
codex exec --skip-git-repo-check "Reply with exactly: pong"

Dans notre essai, les deux ont renvoyé pong : environ 3,0 s pour Claude Code et 3,7 s pour Codex. Si cette étape échoue, T3 Code échouera aussi : commencez toujours le dépannage ici.

Create API Key →

Étape 2 : vérifier l'état des fournisseurs dans T3 Code

Au lancement de t3 ou t3 serve, T3 Code détecte les CLI présentes dans le PATH. Settings → Providers dans l'application web affiche l'état de chaque fournisseur. Voici ce qui a été détecté chez nous :

FournisseurVersionÉtatAuthentificationQuelques modèles détectés
Claude (id d'instance claudeAgent)2.1.319readyauthenticated, type customEndpoint (Custom API endpoint)claude-opus-5-5, claude-sonnet-5-5, claude-fable-5-2, etc.
Codex (id d'instance codex)0.167.0readyunknown (normal : une clé API ne passe pas par la connexion ChatGPT)gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, etc.

T3 Code a donc reconnu que Claude Code passe par un point de terminaison API personnalisé, et les listes de modèles viennent du service configuré.

En plus de la configuration globale, T3 Code gère plusieurs instances, ce qui aide quand une même machine utilise à la fois un abonnement et une clé API :

  • Ajoutez une instance de fournisseur dans Settings → Providers. Selon la documentation, chaque instance peut avoir ses propres variables d'environnement, comme une clé API ou une base URL personnalisée. Marquez les secrets comme sensitive : T3 Code ne réaffiche plus leur valeur après l'enregistrement.
  • Pour Claude, chaque instance peut pointer vers son propre CLAUDE_CONFIG_DIR. Par exemple, gardez le dossier par défaut pour le compte avec abonnement et créez ~/.claude_api pour la configuration avec clé API. Les fils de dossiers de configuration différents restent isolés.
  • Si T3 Code ne trouve pas une CLI (fréquent avec nvm ou mise), renseignez Binary path dans les réglages du fournisseur.

Étape 3 : lancer une vraie tâche dans un fil

Dans l'application web, cliquez sur New thread et choisissez un fournisseur et un modèle. Sur un serveur sans navigateur, utilisez la CLI t3 thread, comme nous l'avons fait :

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 attend la fin du travail de l'agent puis affiche sa réponse. Pour Codex, utilisez --provider codex --model gpt-6.1-sol. Le projet de test tenait en un fichier, avec add volontairement écrit return a-b.

CheminDurée réelleRésultat
T3 Code → Claude Code (claude-opus-5-5)environ 30,4 sCorrigé en return a+b, 6 cas unittest ajoutés, Ran 6 tests ... OK
T3 Code → Codex (gpt-6.1-sol)environ 32,5 sCorrigé en a + b, 5 cas ajoutés, les 5 réussis (OK). Nous avons relancé python3 -m unittest test_calc dans le même dossier ensuite : toujours OK

Dans sa réponse, Claude Code a indiqué que ses deux premiers essais d'écriture du fichier de test avaient perdu l'indentation (IndentationError) et que le troisième, généré par script, avait fonctionné. Lisez le résumé de l'agent, mais fiez-vous aux tests que vous relancez vous-même.

La permission par défaut est Full access : changez-la d'abord

C'est le point le plus important de notre test. Selon la documentation officielle Permission modes, les nouveaux fils démarrent en Full access, sans aucune confirmation pour les commandes et les modifications. Dans la liste des processus, nous avons vu T3 Code lancer Claude Code avec --permission-mode=bypassPermissions.

Changez la valeur par défaut dans Settings → Threads → New threads → Permissions :

ModeComportement
SupervisedDemande une validation avant les commandes et les modifications de fichiers
Auto-accept editsValide automatiquement les modifications de fichiers ; d'autres actions peuvent encore demander une validation
AutoUtilise la revue automatique du fournisseur pour les actions courantes et demande pour le reste
Full accessNe demande jamais

Sur un vrai dépôt, utilisez au minimum Supervised ou Auto. Une équipe peut plafonner les modes disponibles sur une machine avec une managed policy.

Erreurs courantes et solutions

Erreur / symptômeCauseSolution
No T3 Code project matches '.'. Pass a project id or a path inside a project.Le dossier n'est pas encore un projet T3 Code (rencontré lors de notre test)Lancez d'abord t3 project add ., ou démarrez le serveur avec --auto-bootstrap-project-from-cwd
Provider instance "claude" is disabled for project ...--provider n'est pas l'id d'instance. Avec claude nous avons eu cette erreur ; claudeAgent a fonctionnéUtilisez l'id d'instance affiché dans Settings → Providers et vérifiez que le fournisseur est activé
Fournisseur non installé / introuvableLa CLI n'est pas dans le PATH du processus serveur (fréquent avec nvm ou mise)Renseignez Binary path dans les réglages du fournisseur, ou installez la CLI globalement
401 / échec d'authentification dans un filClé erronée ou expirée, ou erreur de configurationLancez d'abord claude -p / codex exec dans un terminal, puis vérifiez clé, base_url et connexion point par point avec le dépannage Codex 401. Revenez à T3 Code une fois le terminal fonctionnel
429 Too Many RequestsLimitation de débit ou fenêtre d'utilisationAttendez ou réduisez la concurrence selon la réponse du serveur ; voir Corriger l'erreur Codex 429
t3 indique qu'un serveur tourne déjàUn seul serveur par dossier de donnéesConnectez-vous au serveur en cours, ou utilisez un autre --base-dir pour un serveur séparé
Le téléphone ou un réseau extérieur ne se connecte pasProblème de liaison distante (retour d'utilisateur de @TheElricLi : téléphone et iPad impossibles à connecter hors de chez lui)La documentation renvoie à la page de dépannage T3 Connect, ou à Tailscale pour une liaison maison

Pour le dépannage complet des erreurs 401 et 429, voir le dépannage Codex 401 Unauthorized et Corriger l'erreur Codex 429 Too Many Requests. Le retour sur la connexion distante vient de ce post de @TheElricLi.

FAQ

T3 Code peut-il utiliser mon abonnement Claude Code ?

Oui, selon la FAQ officielle. Il pilote le Claude Code auquel vous êtes connecté, et votre abonnement fonctionne comme d'habitude. La FAQ affirme aussi que T3 Code respecte les conditions d'utilisation de Claude Code, Codex et Google Antigravity ; c'est la position de T3 Code elle-même.

Faut-il saisir la clé API tierce à part dans T3 Code ?

Non. Écrire la configuration globale des CLI suffit ; c'est ainsi que notre test a tourné. Pour faire cohabiter abonnement et clé API, utilisez des instances de fournisseur ou des dossiers CLAUDE_CONFIG_DIR séparés.

Quelle différence avec l'application de bureau Codex ou Claude Desktop ?

Chacune ne sert que l'agent d'un seul éditeur. T3 Code réunit les agents de plusieurs éditeurs dans une même interface et ajoute l'accès distant et l'application mobile. La contrepartie : un processus serveur de plus à maintenir.

Peut-on l'utiliser sur un serveur sans interface graphique ?

Oui. Démarrez-le avec t3 serve et utilisez la CLI t3 thread, ou connectez-vous depuis un autre appareil avec t3 up ou un lien d'appairage.

Create API Key →

Sources

相关文章

C'est quoi le UI SDK, et comment l'utiliser ? La bibliothèque de comportements Vercel et shadcn pour les agents, installée et testée dans Claude Code / Codex / Cursor (0.1.0-beta.1)

C'est quoi le UI SDK, et comment l'utiliser ? La bibliothèque de comportements Vercel et shadcn pour les agents, installée et testée dans Claude Code / Codex / Cursor (0.1.0-beta.1)

Le UI SDK est la bibliothèque de comportements de Vercel pour les agents, publiée le 12 novembre 2026 en version 0.1.0-beta.1. Les comportements vivent dans le paquet indépendant du framework @ui-sdk/core, puis sont rendus par les adaptateurs React, Vue, Svelte, Solid et Web Components. Ce guide suit la documentation officielle sur ce que c'est, comment l'installer et comment ajouter le skill pour Claude Code, Codex et Cursor, et consigne les commandes, durées et sorties relevées sur notre machine de test.

AWS Emulator, c'est quoi et comment l'installer ? Tester des applications AWS en local avec Claude Code et Codex (testé sur 1.0.322)

AWS Emulator, c'est quoi et comment l'installer ? Tester des applications AWS en local avec Claude Code et Codex (testé sur 1.0.322)

AWS Emulator est l'émulateur local officiel des API AWS, disponible en version GA depuis le 11 novembre 2026 (heure des États-Unis). Il n'entraîne aucuns frais de service supplémentaires, son code source est ouvert, il ne demande aucun compte AWS et couvre plus de 200 services. Nous avons testé la version 1.0.322 sous Debian 13 : commandes d'installation, AWS CLI pointé vers l'endpoint local pour créer un bucket S3 et une table DynamoDB, erreurs rencontrées, et comment laisser Claude Code, Codex et Cursor écrire et tester du code contre l'émulateur.

Claude Code / Codex / Cursor Agent Hooks : configuration PreToolUse, script minimal et test fail-open

Claude Code / Codex / Cursor Agent Hooks : configuration PreToolUse, script minimal et test fail-open

Les instructions, AGENTS.md et skills sont des suggestions que le modèle peut ignorer ; les hooks sont des scripts déterministes exécutés par le harness à des moments fixes. Cet article compare les chemins de configuration, noms d'événements, exit 2 / deny, fail-open et fail-closed entre Claude Code, Codex et Cursor (PreToolUse ou équivalent), et présente un script d'interception minimal testé sur Claude Code.