T3 Code: o que é e quanto gasta do seu plano Claude

O que é o T3 Code, em poucas palavras

O T3 Code é um painel gratuito e de código aberto, com licença MIT, para comandar agentes de programação que já estão instalados e logados numa máquina sua. Ele não vende tokens e não traz um modelo próprio. Quando você usa o Claude por ele, quem trabalha é o seu Claude Code, com o seu login, então cada tarefa sai dos limites de uso do seu plano Pro ou Max.

A versão de referência deste guia é a v0.1.7, marcada como "Latest" no GitHub em 4 de novembro de 2026 e publicada no npm com a tag latest. Todos os comandos abaixo são para você rodar na sua máquina ou no seu servidor.

O que o T3 Code faz, e o que ele não faz

O README do projeto (pingdotgg/t3code) se descreve como uma "agent harness control surface": uma superfície de controle para agentes que rodam na sua própria máquina. Na prática, você ganha uma interface web, um app desktop (Electron) e um app de celular. Com eles você abre conversas, aprova ações e acompanha o trabalho de vários agentes no mesmo lugar.

O agente em si continua sendo outro programa. O README lista Claude Code, Codex, Cursor, Grok Build, OpenCode, Google Antigravity e fx. As notas da v0.1.7 acrescentam o Kiro como provedor em acesso antecipado (Early Access). O próprio README pede que você instale e autentique pelo menos um provedor antes de usar o T3 Code, porque sem isso não há nada para ele comandar.

A licença está no arquivo LICENSE da tag v0.1.7: MIT, com copyright da T3 Tools Inc. Isso significa que o software em si não custa nada. O custo real está no agente que ele aciona.

Existem também builds diários com nomes como 0.1.8-nightly.20261108.4367, publicados no npm com a tag nightly. São pré-lançamentos. Este guia não usa nenhum deles.

O T3 Code usa o seu plano Claude?

Sim. A página do provedor Claude na documentação do T3 Code (providers-claude.md) diz: "T3 Code uses Claude Code's login and configuration." O login acontece na máquina que hospeda o ambiente, e o caminho padrão do binário é claude. Ou seja, se o Claude Code daquela máquina está logado com a sua conta Pro, o T3 Code trabalha com a sua conta Pro.

O FAQ do projeto (faq.md) diz como o T3 Code conversa com o Claude Code: "T3 Code drives Claude through Anthropic's Agent SDK." O código-fonte da v0.1.7 mostra o mesmo. O arquivo apps/server/package.json declara a dependência @anthropic-ai/claude-agent-sdk (versão ^0.3.284). O adaptador do Claude chama a função query() desse SDK e passa o campo pathToClaudeCodeExecutable com o caminho do binário configurado. Em Linux e macOS esse caminho é usado sem alteração. Então cada turno passa pelo Claude Agent SDK, que executa o claude que você mesmo instalou.

Esse detalhe decide qual regra da Anthropic vale. O artigo de ajuda Use the Claude Agent SDK with your Claude plan tem duas atualizações importantes:

• 15 de junho de 2026: a Anthropic suspendeu as mudanças que tinha anunciado para o uso do Agent SDK. O uso do Agent SDK, do claude -p e de apps de terceiros continua saindo dos limites da assinatura.
• 7 de outubro de 2026: os planos Max, Ultra e Team passaram a incluir créditos mensais de API. Esses créditos cobrem o Agent SDK e o claude -p somente quando você usa uma chave de API de uma organização vinculada no Claude Console. Logado com o plano, o Agent SDK e o claude -p continuam consumindo os limites da assinatura.

O artigo não cita o T3 Code pelo nome. Ele se encaixa em "app de terceiros" e, pelo código, também em "Agent SDK". As duas leituras levam à mesma resposta: com o login normal do Claude Code, o T3 Code gasta os mesmos limites de uso que o Claude Code gastaria. Para entender como esses limites se renovam, veja como funcionam os limites de uso do Claude.

Se você quer que o trabalho saia dos créditos de API do Max, a troca é na autenticação, e não no T3 Code. A diferença entre logar com assinatura e com chave de API está em login do Claude Code: assinatura ou chave de API.

Quanto custa usar o Claude pelo T3 Code

O T3 Code é grátis. O que você paga é o plano Claude que já tem. A página oficial do plano Pro informa US$ 20 por mês nos Estados Unidos, com preço em moeda local onde houver suporte. No Brasil, confira o valor em reais na própria tela de assinatura, porque a página de ajuda não mostra esse número.

Quando o limite acaba, a Anthropic oferece pacotes de uso extra. O artigo Buy usage bundles diz que eles estão disponíveis nos planos Pro, Max, Ultra e Team, e a compra fica em Settings > Usage. As outras opções para quando você bate no teto estão em o que fazer quando o limite do Claude acaba.

O limite de 5 horas acaba mais rápido no T3 Code?

Sim, e o próprio projeto documenta isso. O FAQ do T3 Code na v0.1.7 tem a pergunta "Why is my Claude 5-hour limit draining so fast?". A resposta diz que o T3 Code comanda o Claude pelo Agent SDK da Anthropic e que o autor confirmou um bug do lado da Anthropic: todo uso do Agent SDK esgota o limite de 5 horas mais depressa do que o Claude Code usado direto. O mesmo texto diz que isso não afeta os limites semanais e que o problema foi reportado à Anthropic, com a expectativa de uma correção em breve.

O que você pode fazer é medir. As notas da v0.1.7 trazem totais de uso por provedor e por modelo dentro do próprio T3 Code. Rode a mesma tarefa pelos dois caminhos e compare com o que aparece em Settings > Usage na sua conta Claude.

Um ponto documentado afeta conversas longas. Segundo providers-claude.md, o cache de prompt dura cerca de uma hora com assinatura e 5 minutos com chave de API, Bedrock ou Vertex. Para conversas paradas com mais de 200.000 tokens, a tela Settings > Providers > Advanced oferece três modos de compactação: When you return (o padrão, que mostra um botão Compact), Before the cache expires (beta) e Never. O campo Auto-compact after aceita um número inteiro de 100000 a 1000000. Ele define quando o Claude resume a conversa, sem mudar a janela de contexto.

Como usar várias contas Claude no T3 Code

A documentação resolve isso com um diretório de configuração separado para cada conta. Deixe a conta principal no diretório padrão. Para a segunda conta, faça o login apontando a variável CLAUDE_CONFIG_DIR para outra pasta:

CLAUDE_CONFIG_DIR=~/.claude_personal claude auth login

Depois, em Settings > Providers, adicione uma segunda instância do Claude e preencha o campo de diretório de configuração com a mesma pasta. Campo vazio significa a configuração normal do Claude Code. No celular, a opção é Add Claude account em Settings > Providers. Depois do login, confira a conta mostrada nas configurações do provedor.

Não use HOME no lugar de CLAUDE_CONFIG_DIR. A documentação avisa que isso pode gravar as credenciais num lugar onde o provedor não as encontra. As contas ficam isoladas, inclusive o histórico local de conversas. Por isso uma conversa existente só troca entre instâncias que usam o mesmo diretório.

Isso é a parte técnica. Se a dúvida é se você pode dividir uma assinatura com outra pessoa, leia se dá para compartilhar uma conta Claude Pro antes de configurar qualquer coisa.

Instalar o T3 Code fixado na v0.1.7

Instale e logue o Claude Code primeiro. O instalador oficial para macOS e Linux coloca o comando t3 em ~/.local/bin. A variável T3CODE_VERSION fixa uma versão exata. O script acrescenta o v sozinho, então escreva o número sem ele:

curl -fsSL https://t3.codes/install.sh | T3CODE_VERSION=0.1.7 sh
command -v t3

O segundo comando deve imprimir um caminho terminando em .local/bin/t3. Se não imprimir nada, essa pasta não está no seu PATH. Adicione a pasta ao PATH e abra um terminal novo.

Para testar uma vez sem instalar, a documentação indica npx t3@latest, que precisa de Node.js. Hoje latest aponta para a 0.1.7, mas isso muda no próximo lançamento. Para ficar na mesma versão deste guia, fixe o número:

npx t3@0.1.7

Em Macs com processador Intel não existe binário pronto. A documentação manda compilar a partir do código-fonte.

Por que colocar o host do T3 Code num servidor

A página de acesso remoto (remote-access.md) é direta: "That machine must stay running and reachable while you work." Se o host é o seu notebook, fechar a tampa derruba os agentes. Um VPS fica ligado o tempo todo, então você abre o app no celular e encontra a tarefa onde parou. É o mesmo raciocínio de rodar o Claude Code num VPS com tmux, com uma interface por cima.

Rode tudo como um usuário comum, nunca como root. O navegador que o T3 Code usa no host (Chrome) não consegue iniciar o sandbox como root. A página do serviço em segundo plano dá outro motivo: rodar como root cria uma instalação e uma identidade T3 Connect separadas. Num Ubuntu recém-criado, crie o usuário, ative o linger e copie a sua chave SSH para ele:

sudo adduser dev
sudo loginctl enable-linger dev
sudo rsync --archive --chown=dev:dev ~/.ssh /home/dev

Depois saia e entre de novo por SSH direto como dev. Não troque de usuário com sudo -iu, porque o systemctl --user precisa de uma sessão de login de verdade. Já como dev, instale e logue o Claude Code, e então instale o T3 Code com o comando da seção anterior. Alguns hosts Linux precisam de uma preparação única do navegador com sudo t3 browser setup. A documentação cita a variável T3CODE_SERVER_BROWSER_SANDBOX=0 para desligar o sandbox. Não use: ela só existe para quem insiste em rodar como root.

No Linux e no macOS, t3 up instala o T3 Code como serviço em segundo plano. No Linux é um serviço de usuário do systemd chamado t3code.service. O linger faz esse serviço iniciar no boot e continuar rodando depois que você sai da sessão SSH. Sem ele, o serviço para quando a conexão fecha. Para conferir:

t3 service status
systemctl --user status t3code.service

O primeiro comando também mostra onde fica o log. O segundo deve mostrar o serviço como active (running). No Windows não existe serviço em segundo plano: t3 up manda manter t3 serve aberto num terminal, ou deixar o app desktop rodando com o ambiente local ativado.

Como acessar o host remoto: T3 Connect, LAN ou Tailscale

T3 Connect, sem abrir portas

O T3 Connect deixa o ambiente acessível dos seus outros aparelhos sem redirecionamento de porta no roteador. No servidor, rode t3 up e escolha T3 Connect, ou use t3 connect, que equivale a t3 up --connect. Por SSH, o comando mostra um link e um código curto para aprovar em outro aparelho. No app desktop, a opção fica em Settings → Sharing & access.

A página de solução de problemas explica o transporte. Um cloudflared no host abre uma conexão de saída para a Cloudflare na porta 7844, em TCP e UDP. Se o seu VPS bloqueia tráfego de saída, libere essa porta, senão o túnel não sobe.

Cada conta T3 Connect pode vincular até 3 máquinas. Um plano pago do T3 Chat aumenta o limite para 10 máquinas no Pro e 100 no Premier. Não consegui abrir a página de preços do T3 Chat hoje, então confira o valor em t3.chat/pricing.

Pareamento na rede local

O pareamento direto funciona quando o outro aparelho alcança o endereço do host. Na linha de comando, use t3 up --lan ou t3 serve --lan. Com o servidor já rodando, t3 pair cria um novo link. A documentação avisa que, com acesso por LAN ou tailnet ligado, o código de pareamento é a única proteção. Trate esse código como uma senha. Num VPS, a "rede local" é a rede do provedor, então prefira o T3 Connect ou o Tailscale.

Tailscale com HTTPS

Coloque os dois aparelhos na mesma tailnet. Para um servidor novo, use t3 serve --tailscale-serve. Para um servidor que já está rodando, use t3 pair --tailscale. O mapeamento padrão sai com este comando:

tailscale serve --https=443 --set-path=/ off

Se a porta já estiver em uso, existe a opção --tailscale-serve-port. O app só trata um endereço como Tailscale quando a máquina confirma, porque a faixa 100.64.0.0/10 também é usada por outras VPNs, como o Cloudflare WARP. Se você ainda não usa, comece por o que é o Tailscale e como ele cria a sua rede privada.

Limitar e revogar acesso

Sem a opção --scope, um pareamento recebe todas as permissões. Para um aparelho que só precisa ler, limite assim:

t3 pair --scope orchestration:read --scope relay:read
t3 auth session list

A lista mostra as sessões ativas. Remova uma com t3 auth session revoke <id>. Se o seu objetivo principal é programar pelo celular, compare também com as opções em como usar o Claude Code pelo celular.

FAQ

O T3 Code é pago?

Não. O T3 Code tem licença MIT e não cobra pelo uso. Ele aciona agentes que você já tem, como o Claude Code, e esses agentes usam a sua própria assinatura. O único item pago ligado a ele é opcional: um plano do T3 Chat aumenta o número de máquinas no T3 Connect de 3 para 10 (Pro) ou 100 (Premier).

Usar o Claude pelo T3 Code gasta os limites do meu plano Pro ou Max?

Sim. O T3 Code usa o login e a configuração do Claude Code, e a v0.1.7 roda os turnos pelo Claude Agent SDK sobre o claude instalado. O artigo 15036540 da Anthropic diz que o Agent SDK e os apps de terceiros logados com o plano consomem os limites da assinatura. Os créditos mensais de API do Max, Ultra e Team só valem com uma chave de API de uma organização vinculada no Claude Console.

Como coloco duas contas Claude no T3 Code?

Faça o login da segunda conta com outro diretório, por exemplo CLAUDE_CONFIG_DIR=~/.claude_personal claude auth login. Depois adicione uma segunda instância do Claude em Settings > Providers e informe a mesma pasta no campo de diretório de configuração. Não use HOME para isso, porque as credenciais podem ir para um lugar onde o provedor não as encontra.

Por que o T3 Code não deve rodar como root no servidor?

O Chrome que o T3 Code usa no host não consegue iniciar o sandbox como root. Além disso, rodar como root cria uma instalação e uma identidade T3 Connect separadas. Crie um usuário comum, ative o linger com sudo loginctl enable-linger <usuário> e instale tudo como esse usuário.

O serviço em segundo plano funciona no Windows?

Não. No Linux e no macOS, t3 up instala o T3 Code como serviço. No Windows, você precisa manter t3 serve aberto num terminal ou deixar o app desktop rodando com o ambiente local ativado.