Guia de campo do Claude Code em português

Claude Code em português: o que já funciona e o que fica em inglês

O Claude Code entende pedido em português, e uma linha de configuração faz ele responder sempre em português. Os menus e as mensagens fixas da tela continuam em inglês. Abaixo, a configuração language, o ditado por voz em português e onde está a doc oficial traduzida, lida em 18/10/2026.

Ele entende português?

Sim. Você escreve o pedido em português e ele trabalha normalmente. As 22 receitas do guia foram escritas e testadas com pedidos em português, como o da página 131, que transforma fotos de recibos numa planilha. Até as tarefas agendadas se pedem assim: "me lembre às 15h de subir o branch de release" (p. 102). E para mudar uma configuração sem abrir o arquivo, dá para descrever a mudança em português e deixar o /update-config achar a chave e o arquivo certos (p. 39).

Responder sempre em português: a configuração language

Para fixar a língua da resposta, a doc tem a configuração language, descrita assim: "Faça Claude responder em um idioma diferente do inglês por padrão." E explica como ela funciona: "Não há lista fixa para respostas: Claude Code passa o valor verbatim para Claude como uma instrução para sempre responder nesse idioma, então qualquer nome de idioma que Claude possa ler funciona."

Para valer em todos os projetos, ponha no seu arquivo de usuário, ~/.claude/settings.json (no Windows, %USERPROFILE%\.claude\settings.json):

{
  "language": "portuguese"
}

Dois cuidados que a própria doc dá. Primeiro, ninguém confere o que você escreveu: "Claude Code não verifica o valor, então um nome digitado incorretamente chega a Claude como escrito em vez de produzir um erro". Segundo, o padrão: "sem definir; os títulos de sessão então correspondem ao idioma de sua conversa". Ou seja, com a linha acima os títulos automáticos das sessões também saem em português.

Se o arquivo já tem outras chaves, acrescente a linha dentro das mesmas chaves, separada por vírgula. Como as camadas de configuração se combinam está no capítulo 4 do guia; o /config só abre no terminal, não no painel do VS Code nem no app Desktop (p. 39).

Ditado por voz em português

A mesma linha vale para a voz. A doc: "O ditado por voz usa a mesma [configuração language] que controla o idioma de resposta do Claude. Se essa configuração estiver vazia, o ditado usa o padrão em inglês." O português está na lista de idiomas de ditado suportados, com o código pt, e o valor pode ser o código ou o nome do idioma. Para ligar, /voice.

O ditado tem requisitos: login com conta Claude.ai (não funciona com chave de API nem por provedor de nuvem) e um microfone local. E um bônus: "A transcrição não consome mensagens Claude ou tokens e não conta para os limites mostrados em /usage".

O que continua em inglês

A configuração muda a língua das respostas, não a do programa. As mensagens fixas da tela aparecem em inglês até nos exemplos da doc em português: a barra de status mostra ⏸ plan mode on, e o /voice responde Voice mode enabled (hold). Hold space to record. Dictation language: en (/config to change). Os botões de aprovação também, como Yes, manually approve edits; o que cada um faz está traduzido no artigo sobre o plan mode.

Você quer	Como
Pedir em português	Só escrever; não precisa configurar nada
Resposta sempre em português	`"language": "portuguese"` no settings.json
Ditar em português	A mesma linha, mais `/voice`
Menus em português	A doc lida não traz essa opção

A documentação oficial em português

A doc do Claude Code tem versão em português em code.claude.com/docs/pt: as páginas citadas aqui são de lá, como a de configurações, com o link para a seção /docs/pt/settings-reference#language. Nomes de comando, de chave e de botão ficam no original, em inglês.

O guia de campo vai um passo além: é escrito em português do Brasil para quem prefere ler em português (p. 5), com os comandos do Windows e do PowerShell. Para começar do zero, veja Claude Code para iniciantes; para as regras que ele deve seguir sempre, inclusive a língua do projeto, CLAUDE.md.

Fora do livro: code.claude.com/docs/pt/settings-reference, voice-dictation e common-workflows, lidas em 18/10/2026.