O que fica no arquivo de configuração?

Os ajustes que personalizam o Claude Code: as regras de permissão, os hooks, o modelo padrão, o estilo de resposta, a barra de status, variáveis de ambiente e mais. É o painel central da ferramenta, onde as opções que você viu espalhadas pelo curso se reúnem num lugar só.

Preciso editar esse arquivo à mão?

Para a maioria das coisas, não. Muitos ajustes têm comandos próprios, e o Claude Code pode mudar a configuração a seu pedido. Saber que o arquivo existe ajuda a entender a ferramenta, e você recorre a ele direto quando quer um ajuste sem comando fácil ou quer ver tudo que está configurado de uma vez.

Quais são os escopos da configuração?

Pessoal (só você, naquele projeto), do projeto (o time, pelo controle de versão), de usuário (você em todos os projetos) e da organização (definido pela empresa, para todos). A lógica é a mesma da memória e dos comandos: cada escopo serve a um alcance, do seu gosto às regras do time.

O que acontece se dois escopos configuram a mesma coisa?

Entra a precedência, que decide qual vence. Em geral, o mais específico ou restritivo tem prioridade, como uma configuração da empresa acima de uma pessoal, para regras de segurança não serem afrouxadas. As permissões são um caso especial: elas se somam entre escopos, em vez de uma simplesmente vencer.

Por que ver a configuração como um painel de controle?

Porque muda a sua relação com a ferramenta: em vez de ajustes soltos, você enxerga uma ferramenta coerente que molda ao seu jeito. Cada opção, do modelo ao estilo, é um botão nesse painel. Dominá-lo é ter o controle fino da experiência, ajustando o Claude Code para trabalhar como você prefere.

Módulo 14 - Configuração avançada

O arquivo de configuração

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Entender o que é o arquivo de configuração.
Conhecer os escopos: pessoal, projeto e usuário.
Saber como os escopos se combinam por precedência.
Ver o arquivo como o painel de controle da ferramenta.

Os ajustes reunidos num lugar

Ao longo do curso, você já mexeu no arquivo de configuração sem que ele fosse o foco. As regras de permissão do módulo de segurança moram nele. Os hooks do módulo anterior são configurados nele. Ajustes de memória passam por ele. Agora vamos olhar para esse arquivo de frente, porque ele é o painel de controle do Claude Code: o lugar onde se reúnem as opções que personalizam a ferramenta. Entender o arquivo de configuração é ter o mapa de tudo que dá para ajustar, do modelo que o agente usa por padrão ao estilo com que ele responde. É a diferença entre usar a ferramenta como ela vem e moldá-la ao seu jeito.

A boa notícia é que você não precisa editar esse arquivo à mão para a maioria das coisas. Muitos ajustes têm comandos próprios que os alteram por você, e o Claude Code pode mudar a configuração a seu pedido. Ainda assim, saber que existe um arquivo central, e o que ele guarda, ajuda a entender a ferramenta como um todo. Quando você quiser um ajuste que não tem um comando fácil, ou quiser ver tudo que está configurado de uma vez, é ao arquivo de configuração que você recorre. Ele é a fonte única de verdade sobre como o seu Claude Code está ajustado.

Diagrama de um arquivo de configuração central do Claude Code, com caixas internas rotuladas: permissões, hooks, modelo padrão, estilo de resposta, barra de status e variáveis de ambiente, ilustrando que todos os ajustes se reúnem num painel de controle. — O arquivo de configuração é o painel que reúne permissões, hooks, modelo, estilo e outros ajustes.

Os escopos, mais uma vez

A lógica de escopo do arquivo de configuração é a mesma que você já domina de tantos módulos, e reencontrá-la aqui reforça o padrão. A configuração pode ser pessoal, valendo só para você naquele projeto; do projeto, guardada num arquivo que viaja pelo controle de versão e vale para o time todo; ou de usuário, valendo para você em todos os seus projetos. Além desses, ambientes de empresa podem ter uma configuração gerenciada pela organização, que se aplica a todos os funcionários. Cada escopo serve a um alcance: o pessoal para os seus gostos, o do projeto para as regras do time, o de usuário para as suas preferências em todo lugar.

Escopo	Vale para	Bom para
Pessoal (do projeto)	Só você, naquele projeto	Ajustes seus, não compartilhados
Do projeto	O time, pelo controle de versão	Regras que a equipe compartilha
De usuário	Você, em todos os projetos	Suas preferências gerais
Da organização	Todos, definido pela empresa	Regras corporativas que não se afrouxam

Os escopos do arquivo de configuração, na mesma lógica de sempre: pessoal, do time, seu ou da empresa.

🎮 Jogo da aula

Em qual escopo configurar?

Classifique cada ajuste conforme o escopo mais adequado.

Quando dois escopos configuram o mesmo ajuste, entra a precedência, que decide qual vence. A regra geral é que o mais específico ou mais restritivo tende a ter prioridade. Uma configuração da organização, por exemplo, costuma vencer uma pessoal, para que regras corporativas de segurança não sejam afrouxadas por um ajuste individual. Você raramente precisa se preocupar com isso no dia a dia, mas é bom saber que a ordem existe e que ela protege as regras importantes. Um caso especial são as permissões, que, como você viu, se somam entre escopos em vez de simplesmente uma vencer a outra, garantindo que nenhuma trava de segurança se perca.

O painel de controle da ferramenta

Enxergar o arquivo de configuração como um painel de controle muda a sua relação com o Claude Code. Antes, cada ajuste, permissões, hooks, memória, parecia uma coisa separada; agora você vê que todos vivem no mesmo painel, organizados por escopo. Isso te dá uma visão de conjunto: você não ajusta coisas soltas, você configura uma ferramenta coerente do seu jeito. E o painel é rico. Nas próximas aulas, você vai conhecer os ajustes mais úteis que ainda não vimos a fundo: o modelo e o esforço, o estilo das respostas, a barra de status e as variáveis de ambiente. Cada um é um botão nesse painel, e dominá-los é ter o controle fino da experiência.

Com a visão do arquivo de configuração e dos seus escopos, você tem a base para personalizar o Claude Code com intenção, colocando cada ajuste no escopo certo. A próxima aula começa pelos ajustes de modelo: como escolher qual modelo da família Claude o agente usa e quanto esforço ele dedica, decisões que você viu de leve lá no início e que agora ganham profundidade. Ajustar bem o modelo é equilibrar qualidade, velocidade e custo para cada tipo de tarefa, e a configuração é onde você define esse equilíbrio de forma permanente, além de poder mudá-lo na hora.

Teste rápido

O que é o arquivo de configuração do Claude Code?

Perguntas frequentes

O que fica no arquivo de configuração?: Os ajustes que personalizam o Claude Code: as regras de permissão, os hooks, o modelo padrão, o estilo de resposta, a barra de status, variáveis de ambiente e mais. É o painel central da ferramenta, onde as opções que você viu espalhadas pelo curso se reúnem num lugar só.
Preciso editar esse arquivo à mão?: Para a maioria das coisas, não. Muitos ajustes têm comandos próprios, e o Claude Code pode mudar a configuração a seu pedido. Saber que o arquivo existe ajuda a entender a ferramenta, e você recorre a ele direto quando quer um ajuste sem comando fácil ou quer ver tudo que está configurado de uma vez.
Quais são os escopos da configuração?: Pessoal (só você, naquele projeto), do projeto (o time, pelo controle de versão), de usuário (você em todos os projetos) e da organização (definido pela empresa, para todos). A lógica é a mesma da memória e dos comandos: cada escopo serve a um alcance, do seu gosto às regras do time.
O que acontece se dois escopos configuram a mesma coisa?: Entra a precedência, que decide qual vence. Em geral, o mais específico ou restritivo tem prioridade, como uma configuração da empresa acima de uma pessoal, para regras de segurança não serem afrouxadas. As permissões são um caso especial: elas se somam entre escopos, em vez de uma simplesmente vencer.
Por que ver a configuração como um painel de controle?: Porque muda a sua relação com a ferramenta: em vez de ajustes soltos, você enxerga uma ferramenta coerente que molda ao seu jeito. Cada opção, do modelo ao estilo, é um botão nesse painel. Dominá-lo é ter o controle fino da experiência, ajustando o Claude Code para trabalhar como você prefere.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← MCP na prática e o ecossistema Concluir e avançar →