T3 Code: configure Claude Code, Codex e gateways de API

Use o T3 Code para reunir Claude Code e Codex em uma interface e reduzir a transferência manual de tarefas. Primeiro, instale o CLI de um provedor; depois, faça a autenticação ou configure uma instância separada com acesso por API. Verifique a leitura de um arquivo do repositório antes de permitir que o agente altere código.

Em 2026-11-12, a v0.1.9 é a versão estável mais recente. Ela foi lançada em 11 de novembro. O recurso Use T3 Code in another app (MCP) chegou na v0.1.8, lançada em 9 de novembro. Comece pela versão estável, não por uma versão de prévia dos mantenedores.

Quando vale a pena usar o T3 Code?

Escolha o T3 Code para passar tarefas entre agentes com frequência, conduzir tarefas separadas do projeto ou acompanhar o trabalho remotamente. Mantenha seu CLI atual se usa um único agente em um terminal e raramente precisa desses recursos.

O T3 Code é uma interface de controle, não um modelo novo. O ambiente de execução do agente, ou harness, fornece as ferramentas e as executa. O T3 coordena esses ambientes por interfaces de desktop, web e dispositivos móveis.

O projeto oficial oferece suporte a Claude Code, Codex, Cursor, Grok Build, OpenCode, Antigravity e fx, entre outros. Ele é gratuito e tem licença MIT. Você continua pagando ao provedor do modelo. O T3 não revende tokens nem acrescenta uma nova franquia à sua assinatura.

Para quem usa Claude Desktop ou o aplicativo Codex, a questão é saber se uma interface para vários agentes elimina trabalho repetitivo. Nossa comparação entre Codex CLI, aplicativo de desktop e extensão para IDE ajuda quando você só precisa escolher a interface.

Instale um provedor e depois o T3 Code

Instale e autentique o agente na máquina em que o T3 vai executá-lo. Um CLI instalado apenas no seu notebook não configura um servidor separado.

O exercício de transferência da tarefa exige os dois provedores. Para testar apenas um, use o provedor instalado e pare antes da transferência.

Os exemplos de terminal abaixo usam Bash no Linux ou no macOS com Apple Silicon. Comece com um repositório que tenha README.md e nenhum dado sensível de teste.

Para o Claude Code, siga as instruções de instalação nativa da Anthropic:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Para uma instância que usa sua assinatura, execute claude auth login e conclua o login no navegador. Para acesso somente por API, pule o login da assinatura. Conclua a configuração do gateway isolado descrita abaixo antes de iniciar uma conversa.

Para o Codex, o guia oficial do CLI fornece este instalador independente:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex login

Baixe o T3 em t3.codes ou no repositório do GitHub indicado ali. Confira a grafia: o domínio oficial é t3.codes, não t33.codes.

Para usar a interface web local, execute:

curl -fsSL https://t3.codes/install.sh | sh
t3

O comando t3 inicia o servidor e abre o aplicativo web local. Siga qualquer orientação do instalador para adicionar o diretório dele ao PATH.

Com Node.js e npm já disponíveis, você pode fazer um teste pontual com npx t3@latest. Para o aplicativo de desktop no macOS, execute brew install --cask t3-code no terminal.

No Windows, siga primeiro as instruções de instalação do provedor para esse sistema. Depois, instale o T3 no PowerShell:

irm https://t3.codes/install.ps1 | iex
t3

Abra Settings → Providers e selecione o ambiente que contém o repositório. Habilite o provedor nesse ambiente. Para reutilizar um login existente do Codex CLI, adicione uma instância do Codex e escolha Configure manually.

Se um provedor não aparecer, verifique a instalação e o login na máquina desse ambiente. Informe o executável em Binary path quando o T3 não conseguir encontrá-lo no PATH. O guia de instalação explica essas configurações específicas de cada ambiente.

Verifique a leitura de um arquivo e passe a conversa ao Codex

Use uma tarefa somente de leitura para verificar o provedor, o repositório e a execução das ferramentas antes de testar alterações de código.

Adicione o repositório como projeto e abra New thread. Para este exemplo, selecione Claude e escolha explicitamente o modo de permissões Supervised no campo de mensagem. Esse modo solicita aprovação para comandos e alterações de arquivos; revise as solicitações antes de aceitar.

Envie a mensagem abaixo. Ela pede a leitura de README.md, o primeiro título e o comando de testes documentado, sem alterar arquivos nem executar testes.

Read README.md from this repository.
Quote its first heading and identify the documented test command.
If no test command is documented, say so.
Do not modify files or run tests.

Confira a atividade registrada das ferramentas, não apenas a resposta final. Confirme que o agente leu o arquivo correto e retornou o título que realmente está nele. Uma descrição plausível sem a leitura do arquivo não passa nessa verificação.

Quando a resposta terminar, abra o seletor de modelos e escolha sua instância do Codex e um modelo disponível. O atalho é Cmd+Shift+M no macOS ou Ctrl+Shift+M no Windows e no Linux.

Depois, envie esta mensagem para conferir a resposta anterior nos arquivos e verificar se o comando de testes exige preparação adicional:

Review the previous answer against the repository files.
Check whether the proposed test command needs extra setup.
Do not modify files or run tests.

O resultado esperado é uma continuação pelo Codex na mesma conversa do T3, com sua própria atividade de verificação dos arquivos. Esse é um exercício de verificação, não uma promessa de que algum dos modelos encontrará um defeito.

A documentação de transferência de tarefas do T3 distingue o contexto transferido de uma sessão nativa completa. A transferência não copia o raciocínio, o estado das chamadas de ferramentas nem os anexos do provedor anterior. Repita as restrições importantes e anexe novamente o material necessário.

Guarde nas instruções do projeto as convenções que precisam continuar válidas após várias transferências. Nosso guia de memória para agentes de programação aborda esse contexto mais duradouro.

Conecte um gateway de API por uma instância isolada do Claude

Use as variáveis de ambiente da instância do Claude para conectar um gateway compatível com a Anthropic. Não cole credenciais em Launch arguments nem substitua sua instância habitual de assinatura.

Crie um diretório de configuração separado

Mantenha a configuração padrão do Claude intacta. No Bash, crie um diretório para a instância do OpenRouter:

mkdir -p "$HOME/.claude_openrouter"

Se esse diretório já tiver um login da Anthropic salvo, abra uma sessão do Claude que use esse diretório:

CLAUDE_CONFIG_DIR="$HOME/.claude_openrouter" claude

Execute /logout nessa sessão e saia antes de adicionar o token do gateway. Pule essa etapa se o diretório for novo e não tiver um login salvo. A documentação do T3 alerta que credenciais salvas podem entrar em conflito com o token do gateway.

Em Settings → Providers, adicione uma instância do Claude chamada Claude OpenRouter. Defina Binary path como claude e CLAUDE_CONFIG_DIR path como ~/.claude_openrouter.

Preencha Environment variables dessa instância com os valores abaixo, seguindo a configuração oficial do T3 para OpenRouter:

Variável	Valor
`ANTHROPIC_BASE_URL`	`https://openrouter.ai/api`
`ANTHROPIC_AUTH_TOKEN`	Sua própria chave de API do OpenRouter; marque como Sensitive
`ANTHROPIC_API_KEY`	Um valor explicitamente vazio

Mantenha a entrada ANTHROPIC_API_KEY, mas deixe o valor vazio. Não insira aspas como valor. Coloque o token real apenas no campo de credenciais sensíveis, nunca em uma mensagem ao agente ou em um arquivo do repositório.

Crie uma conversa nova para essa instância. Conversas existentes do Claude só podem alternar entre instâncias do Claude que compartilhem o mesmo diretório de configuração.

Selecione o ID exato do modelo e verifique uma solicitação cobrada

Selecione no T3 o ID completo do modelo do gateway. Não presuma que um alias do Claude escolherá esse modelo automaticamente.

Em 2026-11-12, um exemplo do OpenRouter é anthropic/claude-sonnet-5.5. Se ele não aparecer, use Add custom model nas configurações da instância do Claude. Depois, selecione o modelo no seletor do chat.

As variáveis ANTHROPIC_DEFAULT_*_MODEL mapeiam aliases do Claude Code, como sonnet. Elas não substituem o modelo selecionado explicitamente no T3. Modelos personalizados podem ter menos controles de esforço de raciocínio, pensamento ou contexto do que os modelos integrados.

Inicie a conversa nova com a instância do gateway e repita o teste de README.md. Procure a solicitação e o modelo correspondentes no painel de atividade do OpenRouter. Confira o uso e a cobrança ali. Uma boa resposta sem um registro correspondente no gateway não confirma a rota de cobrança.

O OpenRouter documenta o mesmo endpoint e as mesmas variáveis de autenticação no guia de integração com Claude Code. Essas solicitações usam créditos do OpenRouter, não uma franquia adicional de tokens do T3.

Em 2026-11-12, o OpenRouter limita sua garantia de compatibilidade com Claude Code ao provedor direto da Anthropic. Para esse teste, siga a recomendação do guia e priorize Anthropic 1P.

No caso do BetterToken, a documentação de Claude Code indica https://bettertoken.ai como URL base da Anthropic, sem /v1. Use sua própria chave do BetterToken no campo sensível ANTHROPIC_AUTH_TOKEN. Mantenha ANTHROPIC_API_KEY vazio e use um diretório separado, como ~/.claude_bettertoken.

Em 2026-11-12, o catálogo inclui claude-sonnet-5-5. Selecione esse ID exato e repita as verificações de leitura e cobrança antes de tarefas maiores. Esse é um uso de API separado; consulte os preços atuais.

Para um roteador local, use outra instância isolada do Claude e verifique se a máquina do T3 consegue acessar o roteador. O guia de configuração do Claude Code Router explica esse processo adicional de roteamento. Essas variáveis da Anthropic configuram o provedor Claude; elas não são instruções de configuração do Codex.

Use o T3 Code a partir de outro assistente via MCP

Use MCP quando um assistente externo precisar acessar projetos e conversas do T3. Alternar normalmente entre Claude e Codex dentro do T3 não exige essa configuração. Comece com um assistente externo cuja autenticação com o modelo já funcione.

O guia de agentes externos documenta a leitura de projetos, a consulta aos provedores disponíveis e a criação ou envio de mensagens a conversas pelo servidor MCP do T3.

Pressione Cmd/Ctrl+K e escolha Use T3 Code in another app (MCP). A mesma ação está disponível em Settings → Sharing & access. Escolha o cliente e siga as instruções dele.

Em Settings → Environments, abra o menu do ambiente salvo e escolha Copy MCP URL. Mantenha o servidor do T3 em execução. Execute este bloco no Bash, cole a URL copiada quando read aguardar a entrada e pressione Enter:

read -r T3_MCP_URL
claude mcp add --transport http t3 "$T3_MCP_URL"
claude mcp login t3

Para um cliente Codex, use esta alternativa:

read -r T3_MCP_URL
codex mcp add t3 --url "$T3_MCP_URL"
codex mcp login t3

Na primeira conexão, escolha Read only durante a configuração ou a aprovação do login. Esse modo permite consultar os recursos disponíveis sem fazer alterações.

Peça ao assistente externo para listar os projetos do T3 e os provedores disponíveis. Compare o resultado com a interface do T3. Isso verifica uma operação real de ferramenta, não apenas se a URL de um conector foi salva.

Se o login falhar, verifique se o cliente consegue acessar o endereço copiado do ambiente antes de alterar as credenciais de API do modelo.

Conceda acesso de execução apenas quando quiser permitir que esse assistente inicie ou conduza tarefas. Revise o escopo do acesso antes de aprovar. O token de API do modelo e o login MCP são credenciais separadas; alterar uma não corrige a outra conexão.

Confira os limites, a privacidade e a camada que falhou

Ao diagnosticar um problema, separe limites da assinatura, cobranças de API e configuração do cliente.

Em 2026-11-12, o FAQ do T3 ainda relata um consumo mais rápido da franquia de cinco horas do Claude pelo Anthropic Agent SDK do que pelo uso direto do Claude Code. Os mantenedores atribuem isso a um bug do lado da Anthropic. Segundo eles, esse consumo acelerado não afeta os limites semanais; isso não significa que os limites semanais deixem de existir.

Se sua conta tiver uma franquia de cinco horas, compare uma tarefa pequena e representativa antes de levar o dia inteiro de trabalho para o T3. Se essa janela for sua principal restrição, mantenha a opção de usar o Claude Code diretamente.

O FAQ também informa que o T3 não oferece suporte a modelos locais. Um roteador executado localmente que encaminha solicitações a um modelo hospedado não equivale a executar o modelo na sua máquina.

Sobre a inferência, o FAQ afirma que o código e os prompts vão da sua máquina para o provedor, não para os servidores do T3. Um gateway de API passa a fazer parte dessa rota. Isso não significa ausência total de telemetria: o T3 envia metadados de uso, como provedor, modelo e total de tokens.

A documentação de telemetria informa que os eventos de produto não incluem prompts nem conteúdo de arquivos. Leia também as seções separadas de diagnóstico antes de usar repositórios sensíveis.

Se um provedor não aparecer, corrija a instalação, o login ou Binary path na máquina selecionada. Se a autenticação do gateway falhar, confira o token sensível, o valor vazio de ANTHROPIC_API_KEY e a possível existência de um login salvo. Se o modelo estiver indisponível, verifique o ID exato no gateway e a instância selecionada na conversa.

Após cada alteração, inicie uma conversa de teste nova e repita a leitura do arquivo. Mantenha a alteração apenas quando a atividade das ferramentas e o registro de uso do provedor desejado forem compatíveis.