A melhor forma de localizar um app gerado pelo Claude Code é sem sair do Claude Code: instale uma skill de localização, deixe o agente internacionalizar o código-fonte, e deixe a infraestrutura manter todos os idiomas sincronizados a partir daí. O globalize.now é uma infraestrutura de localização baseada em IA feita exatamente para esse ciclo. Ele extrai strings hardcoded transformando-as em chaves de tradução, gera os arquivos de locale e devolve os idiomas traduzidos como pull requests a cada push no git. Este guia percorre todo o processo, de um repositório só em inglês até um PR multilíngue mesclado.

Por que seu app feito com Claude Code está só em inglês?

Porque o Claude Code, como qualquer agente de codificação, escreve os textos voltados ao usuário como strings literais. É o caminho mais curto para chegar a uma funcionalidade que funciona, e nada em um prompt padrão pede chaves de tradução. Quando o app finalmente funciona, o inglês já está hardcoded em centenas de componentes, e plurais e datas são tratados com concatenação de strings que só faz sentido em um único idioma.

A solução tentadora é pedir ao agente para "traduzir o app para o alemão". Isso gera um segundo idioma hardcoded: componentes duplicados ou uma pilha de condicionais ternárias, e cada nova funcionalidade dobra o trabalho. Já cobrimos esse problema em como localizar um app gerado por IA. Traduzir sem internacionalizar é como a dívida de i18n se acumula.

Qual é a melhor forma de localizar um app gerado pelo Claude Code?

Execute o fluxo de localização dentro do próprio agente que construiu o app: uma skill ensina ao Claude Code o procedimento de internacionalização, e a infraestrutura cuida da tradução e da sincronização a cada push. Skills são o formato de extensão suportado oficialmente pela Anthropic para o Claude Code, pastas de instruções que o agente carrega quando uma tarefa corresponde a elas, conforme documentado nos docs de Agent Skills. Elas também são portáteis: a CLI de skills aberta da Vercel instala pacotes de skills no Claude Code, Cursor, Codex e dezenas de outros agentes, então o mesmo fluxo de trabalho acompanha qualquer agente que você use.

Isso é um formato diferente da maioria das ferramentas de localização. Plataformas estabelecidas adicionaram recursos de IA e conectores de agente por cima de um fluxo que ainda gira em torno do próprio painel: suas strings vivem no sistema delas, e o agente é apenas um cliente desse sistema. A localização nativa para agentes inverte essa lógica. O trabalho acontece no seu repositório, o agente cuida da internacionalização, e o globalize.now cuida da tradução e da sincronização. Não existe um banco de conteúdo separado para manter alinhado com seu código, porque o código é o banco de dados.

Como localizar um app feito com Claude Code, passo a passo?

O ciclo completo tem cinco etapas, e o agente cuida da mais pesada delas.

  1. Conecte o repositório em globalize.now. A conversão roda uma única vez, dentro do app, e chega como pull request. Para rodar essa primeira passada direto do Claude Code, instale as skills:

    npx skills add globalize-now/globalize-skills

    Adicione --all se quiser que as skills fiquem disponíveis para todos os agentes da sua máquina, não só para o Claude Code.

  2. Peça ao Claude Code para internacionalizar o app. A skill faz com que ele inspecione o repositório primeiro: qual framework, quais strings são voltadas ao usuário, se já existe alguma configuração de i18n. Ele propõe um plano — a biblioteca, a estrutura de chaves, o layout dos arquivos de locale — e espera sua aprovação antes de mexer no código.

  3. Conecte o repositório ao globalize.now para que cada push dispare a tradução. A configuração para desenvolvedores é uma única conexão, e quem trabalha em ferramentas de IA tem o mesmo fluxo sem precisar tocar em um terminal além do passo 1.

  4. Dê push. As strings novas e alteradas voltam traduzidas, como um pull request que você revisa como qualquer outra mudança de código.

  5. Faça o merge. Adicionar outro idioma depois é uma mudança de configuração, não um projeto novo.

Em um monorepo real em produção, um agente executando esse fluxo internacionalizou o código e gerou cinco idiomas em cerca de 30 minutos. Seu tempo varia conforme o tamanho do projeto, mas é na etapa 2 que uma semana de refatoração manual se transforma em uma única sessão do agente.

O que o agente realmente muda no seu código?

Ele converte strings literais em chamadas de tradução e gera os arquivos de locale que o runtime precisa. Concretamente: ele escolhe ou detecta uma biblioteca de i18n em runtime (i18next, next-intl ou Lingui, dependendo da sua stack), substitui os textos JSX hardcoded por chamadas t() ou componentes de mensagem, gera chaves com nomes coerentes e escreve o arquivo de locale do idioma de origem. Plurais passam a usar formas ICU de verdade em vez de count + " items".

O globalize.now não substitui a biblioteca de runtime, e não traduz repassando o trabalho para uma fila externa. Ele atua uma camada acima: a infraestrutura que gera e mantém as chaves e os arquivos de locale que seu runtime consome. Se você já tem i18next ou next-intl configurado, a skill preserva suas chaves e estrutura existentes e continua o trabalho de onde você parou.

O que acontece no próximo push no git?

Toda vez que você faz push depois da configuração inicial, o que mudou é traduzido, e os idiomas atualizados chegam como pull request. Sem etapa de exportação, sem etapa de importação, sem fila em outra ferramenta separada. A revisão acontece onde os engenheiros já revisam tudo: no diff.

Esse é todo o modelo de operação. Configure uma vez, sincronização automática a cada push no git, sem intervenção manual necessária. O problema clássico dos apps construídos por IA, em que o agente lança funcionalidades mais rápido do que qualquer processo de localização consegue acompanhar, deixa de existir, porque o processo de localização está acoplado ao mesmo push que lança a funcionalidade.

Precisa de um servidor MCP ou de um painel para isso?

Não. O MCP conecta um agente a uma plataforma externa; uma skill ensina o agente a fazer o trabalho onde o código já está. Vários produtos de localização agora oferecem servidores MCP, o que é uma evolução real em relação a copiar e colar em um editor web, mas as strings e seu estado continuam vivendo na plataforma do outro lado dessa conexão, e você ainda precisa reconciliar as duas coisas.

Com o ciclo skill-mais-push, não existe nada para reconciliar. Os arquivos de locale vivem no git, as traduções chegam como commits, e desfazer é git revert. Escrevemos sobre por que esse padrão está se espalhando em as skills do Claude Code estão se tornando o padrão de localização. As duas abordagens superam a era dos painéis; a diferença é onde sua fonte da verdade fica.

Quanto custa localizar um app feito com Claude Code?

O globalize.now custa €20 por mês por workspace, o que inclui €20 de crédito de tradução (cerca de 200.000 palavras) por mês, com uso adicional cobrado por token à mesma taxa por caractere acima disso. Um único plano, sem níveis, sem cobrança por assento, sem cobrança por idioma. Idiomas ilimitados, incluindo RTL. Um SaaS típico com cerca de 10.000 chaves de tradução em 5 idiomas se encaixa tranquilamente dentro do volume incluído.

O cadastro já vem com €5 de crédito de tradução e sem necessidade de cartão, o que cobre aproximadamente um milhão de caracteres. Suficiente para rodar o ciclo completo em um app real antes de pagar qualquer coisa.

Seu app já está pronto. Localizá-lo está a uma instalação de skill e um push de distância.

O globalize.now transforma textos fixos do app em arquivos de locale prontos para tradução e os mantém atualizados a cada novo lançamento.

Experimente o globalize.now grátis