{"content_id":"gqsjob8ujn","slug":"claude-code-setup-permissions-models-context-guide","locale":"pt","schema_type":"TechArticle","category":"tutorial","category_name":"Tutorial","title":"Guia básico do Claude Code: instalação, permissões, modelos e gerenciamento de contexto","summary":"Explica passo a passo desde a instalação e a primeira execução do Claude Code até os modos de permissão, a escolha do modelo, a organização do contexto e a criação do CLAUDE.md. Também corrige, com base na documentação oficial, o sistema de permissões e as informações sobre custos simplificados no material original.","author":{"name":"injoys","url":"https://injoys.com/ko/about"},"key_points":["O Claude Code é uma ferramenta de programação baseada em agentes que pode ler e modificar arquivos no diretório do projeto e executar ferramentas de terminal.","O VS Code é uma opção conveniente, mas não é um requisito, e o Claude Code também pode ser executado em ambientes de terminal compatíveis.","Para iniciantes, é mais seguro revisar o escopo do trabalho no modo Plan e depois mudar para o modo padrão ou Accept Edits.","O custo varia de acordo com o método de autenticação, o modelo escolhido, o contexto de entrada e o número de repetições da tarefa.","O CLAUDE.md não é um repositório de memória das conversas, mas um arquivo de instruções que fornece repetidamente a estrutura, os comandos e as regras do projeto."],"content_markdown":"Claude Code é uma ferramenta de desenvolvimento agêntica que permite usar o Claude da Anthropic no terminal e em repositórios de código. Além de responder com trechos de código, ela explora e edita arquivos, executa comandos, realiza testes e analisa erros dentro do escopo permitido.\n\nEste guia explica não apenas o procedimento de instalação, mas também como configurar permissões com segurança, quais critérios usar para escolher o modelo adequado à tarefa e como gerenciar o contexto e as instruções do projeto. Como os comandos e ambientes compatíveis podem ser atualizados, durante a instalação é necessário verificar os comandos mais recentes exibidos na documentação oficial de configuração.\n\n## Três formas de programar com Claude\n\nCada forma se diferencia menos pelo resultado e mais pelo **nível de interação da ferramenta com o projeto local**.\n\n| Forma | Acesso a arquivos locais | Execução de comandos | Tarefas adequadas | Principais limitações |\n|---|---:|---:|---|---|\n| Claude na web | Limitado por padrão | Indisponível por padrão | Perguntas, explicações de código, exemplos curtos, revisão de design | É necessário copiar e executar para aplicar as respostas diretamente ao projeto |\n| Aplicativo Claude para desktop | Varia conforme recursos, integrações e aprovação do usuário | Varia conforme recursos e integrações | Trabalho com documentos, tarefas centradas em conversas, integrações locais compatíveis | Não controla automaticamente o repositório e o shell em todos os ambientes de instalação |\n| Claude Code | Possível dentro do escopo do projeto | Possível conforme a política de permissões | Alteração de repositórios reais, testes, refatoração, projetos de longo prazo | Como lida com permissões de shell e arquivos, requer revisão e configuração de segurança |\n\nClaude Code não é destinado apenas a desenvolvedores profissionais. No entanto, como pode realizar tarefas que afetam o sistema, como excluir arquivos, instalar dependências e executar scripts de build, recomenda-se que iniciantes usem o modo Plan junto com controle de versão.\n\n## Preparação antes da instalação\n\nPrepare primeiro os seguintes itens.\n\n- Consulte na documentação oficial os sistemas operacionais e ambientes de shell atualmente compatíveis.\n- Prepare uma conta Anthropic que permita usar Claude Code ou um ambiente compatível de autenticação e cobrança.\n- Se for um projeto existente, crie um repositório Git e faça commit das alterações ou um backup.\n- Identifique os comandos de teste, build e lint do projeto.\n- É possível usar um editor como o VS Code, mas o próprio VS Code não é um requisito para Claude Code.\n\nNo Windows, é necessário verificar as condições para PowerShell, Prompt de Comando ou WSL indicadas na documentação oficial. Se o computador for gerenciado por uma organização, verifique primeiro também as permissões de instalação, o proxy, o firewall e as políticas de tratamento de dados.\n\n## Instalação e primeira execução do Claude Code\n\n### 1. Verifique o comando oficial de instalação\n\nNa documentação oficial de configuração do Claude Code, selecione o método de instalação mais recente correspondente ao sistema operacional. Como o método e os comandos de instalação podem mudar, use a documentação oficial como referência em vez de reutilizar diretamente comandos de vídeos ou blogs antigos.\n\n### 2. Abra a pasta do projeto\n\nCrie uma nova pasta ou acesse um repositório existente. Se estiver usando o VS Code, abra a pasta em **File \u003e Open Folder** e depois selecione **Terminal \u003e New Terminal**.\n\n```bash\ncd path/to/project\nclaude\n```\n\nAo executar `claude`, poderá ser exibido um procedimento de autenticação no navegador, se necessário. Após o login, Claude Code analisa o projeto com base no diretório de trabalho atual. Portanto, é mais seguro executá-lo na raiz do repositório real do que no diretório pessoal ou em uma pasta superior excessivamente abrangente.\n\n### 3. Comece com uma solicitação pequena\n\nEm vez de encarregá-lo desde o início de criar a aplicação inteira, divida o escopo da seguinte forma.\n\n1. Peça para ler e resumir a estrutura do projeto.\n2. Peça para apresentar o plano de implementação e os arquivos que serão alterados.\n3. Peça para implementar apenas uma funcionalidade.\n4. Peça para executar testes ou análise estática.\n5. Peça para explicar as alterações e os riscos restantes.\n\nExemplo de solicitação:\n\n```text\nLeia este repositório e resuma a estrutura e como executá-lo. Ainda não modifique\narquivos; apenas proponha um plano para adicionar um formulário de login e os arquivos que serão alterados.\n```\n\n## Modos de permissão e configuração segura\n\nOs textos exibidos para os modos de permissão do Claude Code podem variar conforme a versão e a tela de configuração. Os principais conceitos de modos usados nas configurações oficiais são os seguintes.\n\n| Modo | Comportamento | Situação recomendada |\n|---|---|---|\n| Default | Solicita aprovação conforme necessário ao editar arquivos ou executar ferramentas que possam apresentar riscos | Tarefas cotidianas comuns |\n| Accept Edits | Permite automaticamente a edição de arquivos, mas outras ferramentas ainda podem exigir aprovação separada | Trabalho de desenvolvimento em que os arquivos alterados são rastreados pelo Git |\n| Plan | Concentra-se na análise e no planejamento sem modificar arquivos nem executar comandos | Compreensão do repositório, revisão de design, primeira etapa para iniciantes |\n| Don't Ask | Política não interativa que rejeita operações não autorizadas previamente em vez de perguntar | Ao usar ambientes de automação ou listas de permissões rigorosas |\n| Bypass Permissions | Ignora o procedimento de verificação de permissões | Deve ser evitado fora de ambientes com riscos controlados, como contêineres isolados |\n\n`Shift+Tab` pode ser usado para alternar entre alguns estados de permissão disponíveis na interface interativa. No entanto, como nem todas as configurações necessariamente são percorridas apenas com esse atalho, é necessário verificar o indicador de estado na tela atual e a documentação oficial de permissões.\n\n### Fluxo recomendado para iniciantes\n\n1. Receba um plano de implementação no modo Plan.\n2. Revise os arquivos que serão alterados e os comandos que serão executados.\n3. Faça a implementação no modo Default ou Accept Edits.\n4. Verifique pessoalmente instalações de pacotes, alterações no banco de dados e comandos de exclusão.\n5. Revise o `git diff` e os resultados dos testes antes de fazer o commit.\n\nBypass Permissions não é simplesmente um modo rápido e conveniente. Como pode ampliar os danos causados por comandos incorretos, acesso excessivo a arquivos ou exposição de informações confidenciais, não deve ser usado como padrão em computadores pessoais ou repositórios importantes.\n\n## Seleção de modelo e gerenciamento de custos\n\nEm uma sessão interativa, use `/model` para verificar ou alterar os modelos disponíveis na conta e no ambiente. Como os nomes, aliases e a disponibilidade dos modelos podem variar conforme o momento e o método de autenticação, é melhor não criar automações que pressuponham uma lista fixa de modelos.\n\n```text\n/model\n```\n\nOs princípios gerais de seleção são os seguintes.\n\n| Tipo de tarefa | Critério de seleção |\n|---|---|\n| Design de arquitetura, depuração difícil, raciocínio complexo | Considere primeiro um modelo de alto desempenho |\n| Implementação geral, criação de testes, desenvolvimento repetitivo | Considere um modelo com bom equilíbrio entre desempenho e velocidade |\n| Pesquisa simples, conversão de formato, correções curtas | Se houver suporte na conta, considere um modelo rápido e econômico |\n\nOpus, Sonnet e Haiku são nomes que distinguem famílias de modelos, mas a versão exata de cada família e sua compatibilidade com Claude Code podem mudar continuamente. Em alguns ambientes, é possível usar aliases como `/model sonnet`, mas o mais preciso é verificar as opções exibidas na sessão atual.\n\n### Formas práticas de reduzir custos\n\n- Execute no subdiretório necessário para reduzir a exploração de arquivos desnecessários.\n- Informe de uma só vez o objetivo, as restrições e os critérios de conclusão para reduzir retrabalho.\n- Em vez de fornecer logs extensos completos, forneça o trecho em torno do erro e as etapas de reprodução.\n- Exclua caminhos desnecessários, como arquivos gerados, resultados de build e grandes conjuntos de dados.\n- Depois de concluir a exploração e o design, organize a sessão em uma nova unidade de trabalho.\n- Para tarefas simples, use um modelo mais rápido e barato, dentro das opções disponíveis.\n- Se o uso for baseado em API, consulte tanto os comandos relacionados a custos quanto as informações de uso no Anthropic Console.\n\nA estrutura de custos varia conforme o método de login. Contas de assinatura do Claude podem ter limites de uso por plano, enquanto o uso por meio da API da Anthropic ou de provedores de nuvem pode ser cobrado com base em tokens. Portanto, não se deve presumir que determinado modelo seja sempre gratuito ou custe apenas um valor fixo.\n\n## Gerenciamento da janela de contexto\n\nA janela de contexto é o conjunto de conversas, conteúdo de arquivos, resultados de ferramentas, instruções do projeto e outros dados que o modelo pode consultar ao gerar a resposta atual. Ela não é equivalente a uma memória permanente nem simplesmente ao número de caracteres da conversa.\n\n### Principais comandos\n\n| Comando | Finalidade | Observação |\n|---|---|---|\n| `/context` | Verificar a composição do uso do contexto | A forma de exibição pode variar conforme a versão |\n| `/compact` | Resumir a conversa atual para liberar espaço no contexto | Detalhes podem ser condensados durante o processo de resumo |\n| `/clear` | Apagar o histórico da conversa atual e iniciar uma nova | Primeiro, registre em um documento as decisões necessárias e o estado do trabalho |\n\nNão existe um critério universal segundo o qual a qualidade das respostas necessariamente diminui quando o contexto ultrapassa determinada porcentagem. Claude Code também pode realizar compactação automática, e a qualidade é afetada não apenas pela quantidade de informações incluídas, mas também por sua relevância, redundância e possíveis conflitos.\n\nConsidere organizar o contexto quando notar os seguintes sinais.\n\n- Deixa repetidamente de considerar requisitos que já foram alterados.\n- Confunde um estado antigo dos arquivos com o estado atual.\n- Mistura condições de funcionalidades diferentes.\n- Lê repetidamente o mesmo arquivo sem necessidade.\n- A conversa e a saída das ferramentas ficaram excessivamente longas.\n\nNão é necessário executar `/clear` obrigatoriamente sempre que uma funcionalidade for concluída. Em vez disso, registre as decisões concluídas, os itens pendentes e os resultados dos testes na documentação do projeto ou no histórico de trabalho antes de iniciar uma nova sessão, reduzindo assim a perda de informações.\n\n## Gerenciamento das instruções do projeto com CLAUDE.md\n\nO nome do arquivo geralmente é escrito como `CLAUDE.md`, incluindo letras maiúsculas. Esse arquivo não é uma memória permanente do Claude, mas um documento persistente de instruções que Claude Code consulta no projeto. Incluí-lo no repositório permite compartilhar as instruções com a equipe, mas informações confidenciais não devem ser registradas nele.\n\nÉ possível usar o comando `/init` para analisar o projeto e começar a criar o `CLAUDE.md` inicial, mas o resultado deve obrigatoriamente ser revisado por uma pessoa.\n\n### Conteúdo recomendado\n\n- Objetivo e principais funcionalidades do projeto\n- Linguagens, frameworks e versões de runtime utilizados\n- Função dos diretórios e módulos importantes\n- Comandos de instalação, servidor de desenvolvimento, teste, lint e build\n- Estilo de código e convenções de nomenclatura\n- Arquivos que não devem ser modificados ou código gerado\n- Princípios de segurança e tratamento de dados pessoais\n- Critérios de conclusão das tarefas e procedimento de validação\n\nExemplo:\n\n```markdown\n# Project instructions\n\n## Stack\n- Usamos TypeScript e Node.js.\n- O gerenciador de pacotes é o pnpm.\n\n## Commands\n- Teste: `pnpm test`\n- Lint: `pnpm lint`\n- Build: `pnpm build`\n\n## Rules\n- Não leia nem faça commit do `.env` e de credenciais reais.\n- Antes de alterar o formato de resposta de uma API pública, apresente primeiro um plano.\n- Adicione testes relacionados às alterações de funcionalidades.\n```\n\nNão existe um limite máximo oficial de 200 linhas para o `CLAUDE.md`. No entanto, instruções longas demais podem consumir contexto e criar conflitos entre regras, portanto é mais prático mantê-las curtas e específicas. Separe explicações detalhadas de design em documentos próprios e indique os caminhos necessários.\n\n## Procedimento de trabalho recomendado\n\nO procedimento básico para aumentar simultaneamente a segurança e a qualidade dos resultados é o seguinte.\n\n1. Verifique se o estado do Git está limpo e crie um backup ou commit.\n2. Execute Claude Code na raiz do repositório.\n3. Verifique o `CLAUDE.md` e a documentação existente.\n4. No modo Plan, receba o objetivo, os arquivos que serão modificados e o plano de testes.\n5. Divida tarefas grandes em pequenas unidades que possam ser revisadas.\n6. Implemente uma unidade por vez no modo Default ou Accept Edits.\n7. Revise pessoalmente comandos de instalação, exclusão, implantação e alteração de dados.\n8. Verifique testes, lint, checagem de tipos e o `git diff`.\n9. Documente o estado de conclusão e os problemas restantes.\n10. Se a próxima tarefa não estiver relacionada à conversa anterior, inicie uma nova sessão com `/clear`.\n\n## Checklist de segurança\n\n- Evite que `.env`, chaves de API, certificados e dados de clientes sejam expostos em prompts ou no repositório.\n- Não faça experimentos diretamente em servidores e bancos de dados de produção.\n- Leia comandos de shell ou scripts de instalação de origem desconhecida antes de executá-los.\n- Mesmo no código escrito pelo Claude, revise dependências, licenças, vulnerabilidades de segurança e testes.\n- Em tarefas importantes, aplique o princípio do menor privilégio e use um ambiente de desenvolvimento isolado.\n- Verifique alterações geradas automaticamente com o Git diff e mantenha a responsabilidade final com uma pessoa.\n\nClaude Code pode reduzir significativamente o tempo do processo de desenvolvimento, mas não é um mecanismo automático que garanta a precisão e a segurança dos resultados. A forma mais confiável de usá-lo é combinar instruções claras, permissões limitadas, pequenas unidades de alteração, testes automatizados e revisão humana.","content_html":"\u003cp\u003eClaude Code é uma ferramenta de desenvolvimento agêntica que permite usar o Claude da Anthropic no terminal e em repositórios de código. Além de responder com trechos de código, ela explora e edita arquivos, executa comandos, realiza testes e analisa erros dentro do escopo permitido.\u003c/p\u003e\n\u003cp\u003eEste guia explica não apenas o procedimento de instalação, mas também como configurar permissões com segurança, quais critérios usar para escolher o modelo adequado à tarefa e como gerenciar o contexto e as instruções do projeto. Como os comandos e ambientes compatíveis podem ser atualizados, durante a instalação é necessário verificar os comandos mais recentes exibidos na documentação oficial de configuração.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#tr%C3%AAs-formas-de-programar-com-claude\" class=\"anchor\" id=\"três-formas-de-programar-com-claude\"\u003e\u003c/a\u003eTrês formas de programar com Claude\u003c/h2\u003e\n\u003cp\u003eCada forma se diferencia menos pelo resultado e mais pelo \u003cstrong\u003enível de interação da ferramenta com o projeto local\u003c/strong\u003e.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eForma\u003c/th\u003e\n\u003cth\u003eAcesso a arquivos locais\u003c/th\u003e\n\u003cth\u003eExecução de comandos\u003c/th\u003e\n\u003cth\u003eTarefas adequadas\u003c/th\u003e\n\u003cth\u003ePrincipais limitações\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Forma\"\u003eClaude na web\u003c/td\u003e\n\u003ctd data-label=\"Acesso a arquivos locais\"\u003eLimitado por padrão\u003c/td\u003e\n\u003ctd data-label=\"Execução de comandos\"\u003eIndisponível por padrão\u003c/td\u003e\n\u003ctd data-label=\"Tarefas adequadas\"\u003ePerguntas, explicações de código, exemplos curtos, revisão de design\u003c/td\u003e\n\u003ctd data-label=\"Principais limitações\"\u003eÉ necessário copiar e executar para aplicar as respostas diretamente ao projeto\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Forma\"\u003eAplicativo Claude para desktop\u003c/td\u003e\n\u003ctd data-label=\"Acesso a arquivos locais\"\u003eVaria conforme recursos, integrações e aprovação do usuário\u003c/td\u003e\n\u003ctd data-label=\"Execução de comandos\"\u003eVaria conforme recursos e integrações\u003c/td\u003e\n\u003ctd data-label=\"Tarefas adequadas\"\u003eTrabalho com documentos, tarefas centradas em conversas, integrações locais compatíveis\u003c/td\u003e\n\u003ctd data-label=\"Principais limitações\"\u003eNão controla automaticamente o repositório e o shell em todos os ambientes de instalação\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Forma\"\u003eClaude Code\u003c/td\u003e\n\u003ctd data-label=\"Acesso a arquivos locais\"\u003ePossível dentro do escopo do projeto\u003c/td\u003e\n\u003ctd data-label=\"Execução de comandos\"\u003ePossível conforme a política de permissões\u003c/td\u003e\n\u003ctd data-label=\"Tarefas adequadas\"\u003eAlteração de repositórios reais, testes, refatoração, projetos de longo prazo\u003c/td\u003e\n\u003ctd data-label=\"Principais limitações\"\u003eComo lida com permissões de shell e arquivos, requer revisão e configuração de segurança\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eClaude Code não é destinado apenas a desenvolvedores profissionais. No entanto, como pode realizar tarefas que afetam o sistema, como excluir arquivos, instalar dependências e executar scripts de build, recomenda-se que iniciantes usem o modo Plan junto com controle de versão.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#prepara%C3%A7%C3%A3o-antes-da-instala%C3%A7%C3%A3o\" class=\"anchor\" id=\"preparação-antes-da-instalação\"\u003e\u003c/a\u003ePreparação antes da instalação\u003c/h2\u003e\n\u003cp\u003ePrepare primeiro os seguintes itens.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eConsulte na documentação oficial os sistemas operacionais e ambientes de shell atualmente compatíveis.\u003c/li\u003e\n\u003cli\u003ePrepare uma conta Anthropic que permita usar Claude Code ou um ambiente compatível de autenticação e cobrança.\u003c/li\u003e\n\u003cli\u003eSe for um projeto existente, crie um repositório Git e faça commit das alterações ou um backup.\u003c/li\u003e\n\u003cli\u003eIdentifique os comandos de teste, build e lint do projeto.\u003c/li\u003e\n\u003cli\u003eÉ possível usar um editor como o VS Code, mas o próprio VS Code não é um requisito para Claude Code.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eNo Windows, é necessário verificar as condições para PowerShell, Prompt de Comando ou WSL indicadas na documentação oficial. Se o computador for gerenciado por uma organização, verifique primeiro também as permissões de instalação, o proxy, o firewall e as políticas de tratamento de dados.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#instala%C3%A7%C3%A3o-e-primeira-execu%C3%A7%C3%A3o-do-claude-code\" class=\"anchor\" id=\"instalação-e-primeira-execução-do-claude-code\"\u003e\u003c/a\u003eInstalação e primeira execução do Claude Code\u003c/h2\u003e\n\u003ch3\u003e\n\u003ca href=\"#1-verifique-o-comando-oficial-de-instala%C3%A7%C3%A3o\" class=\"anchor\" id=\"1-verifique-o-comando-oficial-de-instalação\"\u003e\u003c/a\u003e1. Verifique o comando oficial de instalação\u003c/h3\u003e\n\u003cp\u003eNa documentação oficial de configuração do Claude Code, selecione o método de instalação mais recente correspondente ao sistema operacional. Como o método e os comandos de instalação podem mudar, use a documentação oficial como referência em vez de reutilizar diretamente comandos de vídeos ou blogs antigos.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#2-abra-a-pasta-do-projeto\" class=\"anchor\" id=\"2-abra-a-pasta-do-projeto\"\u003e\u003c/a\u003e2. Abra a pasta do projeto\u003c/h3\u003e\n\u003cp\u003eCrie uma nova pasta ou acesse um repositório existente. Se estiver usando o VS Code, abra a pasta em \u003cstrong\u003eFile \u0026gt; Open Folder\u003c/strong\u003e e depois selecione \u003cstrong\u003eTerminal \u0026gt; New Terminal\u003c/strong\u003e.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003ecd\u003c/span\u003e\u003cspan\u003e path/to/project\n\u003c/span\u003e\u003cspan\u003eclaude\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eAo executar \u003ccode\u003eclaude\u003c/code\u003e, poderá ser exibido um procedimento de autenticação no navegador, se necessário. Após o login, Claude Code analisa o projeto com base no diretório de trabalho atual. Portanto, é mais seguro executá-lo na raiz do repositório real do que no diretório pessoal ou em uma pasta superior excessivamente abrangente.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#3-comece-com-uma-solicita%C3%A7%C3%A3o-pequena\" class=\"anchor\" id=\"3-comece-com-uma-solicitação-pequena\"\u003e\u003c/a\u003e3. Comece com uma solicitação pequena\u003c/h3\u003e\n\u003cp\u003eEm vez de encarregá-lo desde o início de criar a aplicação inteira, divida o escopo da seguinte forma.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003ePeça para ler e resumir a estrutura do projeto.\u003c/li\u003e\n\u003cli\u003ePeça para apresentar o plano de implementação e os arquivos que serão alterados.\u003c/li\u003e\n\u003cli\u003ePeça para implementar apenas uma funcionalidade.\u003c/li\u003e\n\u003cli\u003ePeça para executar testes ou análise estática.\u003c/li\u003e\n\u003cli\u003ePeça para explicar as alterações e os riscos restantes.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eExemplo de solicitação:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eLeia este repositório e resuma a estrutura e como executá-lo. Ainda não modifique\n\u003c/span\u003e\u003cspan\u003earquivos; apenas proponha um plano para adicionar um formulário de login e os arquivos que serão alterados.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch2\u003e\n\u003ca href=\"#modos-de-permiss%C3%A3o-e-configura%C3%A7%C3%A3o-segura\" class=\"anchor\" id=\"modos-de-permissão-e-configuração-segura\"\u003e\u003c/a\u003eModos de permissão e configuração segura\u003c/h2\u003e\n\u003cp\u003eOs textos exibidos para os modos de permissão do Claude Code podem variar conforme a versão e a tela de configuração. Os principais conceitos de modos usados nas configurações oficiais são os seguintes.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eModo\u003c/th\u003e\n\u003cth\u003eComportamento\u003c/th\u003e\n\u003cth\u003eSituação recomendada\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eDefault\u003c/td\u003e\n\u003ctd data-label=\"Comportamento\"\u003eSolicita aprovação conforme necessário ao editar arquivos ou executar ferramentas que possam apresentar riscos\u003c/td\u003e\n\u003ctd data-label=\"Situação recomendada\"\u003eTarefas cotidianas comuns\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eAccept Edits\u003c/td\u003e\n\u003ctd data-label=\"Comportamento\"\u003ePermite automaticamente a edição de arquivos, mas outras ferramentas ainda podem exigir aprovação separada\u003c/td\u003e\n\u003ctd data-label=\"Situação recomendada\"\u003eTrabalho de desenvolvimento em que os arquivos alterados são rastreados pelo Git\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003ePlan\u003c/td\u003e\n\u003ctd data-label=\"Comportamento\"\u003eConcentra-se na análise e no planejamento sem modificar arquivos nem executar comandos\u003c/td\u003e\n\u003ctd data-label=\"Situação recomendada\"\u003eCompreensão do repositório, revisão de design, primeira etapa para iniciantes\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eDon't Ask\u003c/td\u003e\n\u003ctd data-label=\"Comportamento\"\u003ePolítica não interativa que rejeita operações não autorizadas previamente em vez de perguntar\u003c/td\u003e\n\u003ctd data-label=\"Situação recomendada\"\u003eAo usar ambientes de automação ou listas de permissões rigorosas\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Modo\"\u003eBypass Permissions\u003c/td\u003e\n\u003ctd data-label=\"Comportamento\"\u003eIgnora o procedimento de verificação de permissões\u003c/td\u003e\n\u003ctd data-label=\"Situação recomendada\"\u003eDeve ser evitado fora de ambientes com riscos controlados, como contêineres isolados\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003e\u003ccode\u003eShift+Tab\u003c/code\u003e pode ser usado para alternar entre alguns estados de permissão disponíveis na interface interativa. No entanto, como nem todas as configurações necessariamente são percorridas apenas com esse atalho, é necessário verificar o indicador de estado na tela atual e a documentação oficial de permissões.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#fluxo-recomendado-para-iniciantes\" class=\"anchor\" id=\"fluxo-recomendado-para-iniciantes\"\u003e\u003c/a\u003eFluxo recomendado para iniciantes\u003c/h3\u003e\n\u003col\u003e\n\u003cli\u003eReceba um plano de implementação no modo Plan.\u003c/li\u003e\n\u003cli\u003eRevise os arquivos que serão alterados e os comandos que serão executados.\u003c/li\u003e\n\u003cli\u003eFaça a implementação no modo Default ou Accept Edits.\u003c/li\u003e\n\u003cli\u003eVerifique pessoalmente instalações de pacotes, alterações no banco de dados e comandos de exclusão.\u003c/li\u003e\n\u003cli\u003eRevise o \u003ccode\u003egit diff\u003c/code\u003e e os resultados dos testes antes de fazer o commit.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eBypass Permissions não é simplesmente um modo rápido e conveniente. Como pode ampliar os danos causados por comandos incorretos, acesso excessivo a arquivos ou exposição de informações confidenciais, não deve ser usado como padrão em computadores pessoais ou repositórios importantes.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#sele%C3%A7%C3%A3o-de-modelo-e-gerenciamento-de-custos\" class=\"anchor\" id=\"seleção-de-modelo-e-gerenciamento-de-custos\"\u003e\u003c/a\u003eSeleção de modelo e gerenciamento de custos\u003c/h2\u003e\n\u003cp\u003eEm uma sessão interativa, use \u003ccode\u003e/model\u003c/code\u003e para verificar ou alterar os modelos disponíveis na conta e no ambiente. Como os nomes, aliases e a disponibilidade dos modelos podem variar conforme o momento e o método de autenticação, é melhor não criar automações que pressuponham uma lista fixa de modelos.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e/model\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eOs princípios gerais de seleção são os seguintes.\u003c/p\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eTipo de tarefa\u003c/th\u003e\n\u003cth\u003eCritério de seleção\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Tipo de tarefa\"\u003eDesign de arquitetura, depuração difícil, raciocínio complexo\u003c/td\u003e\n\u003ctd data-label=\"Critério de seleção\"\u003eConsidere primeiro um modelo de alto desempenho\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Tipo de tarefa\"\u003eImplementação geral, criação de testes, desenvolvimento repetitivo\u003c/td\u003e\n\u003ctd data-label=\"Critério de seleção\"\u003eConsidere um modelo com bom equilíbrio entre desempenho e velocidade\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Tipo de tarefa\"\u003ePesquisa simples, conversão de formato, correções curtas\u003c/td\u003e\n\u003ctd data-label=\"Critério de seleção\"\u003eSe houver suporte na conta, considere um modelo rápido e econômico\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eOpus, Sonnet e Haiku são nomes que distinguem famílias de modelos, mas a versão exata de cada família e sua compatibilidade com Claude Code podem mudar continuamente. Em alguns ambientes, é possível usar aliases como \u003ccode\u003e/model sonnet\u003c/code\u003e, mas o mais preciso é verificar as opções exibidas na sessão atual.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#formas-pr%C3%A1ticas-de-reduzir-custos\" class=\"anchor\" id=\"formas-práticas-de-reduzir-custos\"\u003e\u003c/a\u003eFormas práticas de reduzir custos\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eExecute no subdiretório necessário para reduzir a exploração de arquivos desnecessários.\u003c/li\u003e\n\u003cli\u003eInforme de uma só vez o objetivo, as restrições e os critérios de conclusão para reduzir retrabalho.\u003c/li\u003e\n\u003cli\u003eEm vez de fornecer logs extensos completos, forneça o trecho em torno do erro e as etapas de reprodução.\u003c/li\u003e\n\u003cli\u003eExclua caminhos desnecessários, como arquivos gerados, resultados de build e grandes conjuntos de dados.\u003c/li\u003e\n\u003cli\u003eDepois de concluir a exploração e o design, organize a sessão em uma nova unidade de trabalho.\u003c/li\u003e\n\u003cli\u003ePara tarefas simples, use um modelo mais rápido e barato, dentro das opções disponíveis.\u003c/li\u003e\n\u003cli\u003eSe o uso for baseado em API, consulte tanto os comandos relacionados a custos quanto as informações de uso no Anthropic Console.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eA estrutura de custos varia conforme o método de login. Contas de assinatura do Claude podem ter limites de uso por plano, enquanto o uso por meio da API da Anthropic ou de provedores de nuvem pode ser cobrado com base em tokens. Portanto, não se deve presumir que determinado modelo seja sempre gratuito ou custe apenas um valor fixo.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#gerenciamento-da-janela-de-contexto\" class=\"anchor\" id=\"gerenciamento-da-janela-de-contexto\"\u003e\u003c/a\u003eGerenciamento da janela de contexto\u003c/h2\u003e\n\u003cp\u003eA janela de contexto é o conjunto de conversas, conteúdo de arquivos, resultados de ferramentas, instruções do projeto e outros dados que o modelo pode consultar ao gerar a resposta atual. Ela não é equivalente a uma memória permanente nem simplesmente ao número de caracteres da conversa.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#principais-comandos\" class=\"anchor\" id=\"principais-comandos\"\u003e\u003c/a\u003ePrincipais comandos\u003c/h3\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eComando\u003c/th\u003e\n\u003cth\u003eFinalidade\u003c/th\u003e\n\u003cth\u003eObservação\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Comando\"\u003e\u003ccode\u003e/context\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Finalidade\"\u003eVerificar a composição do uso do contexto\u003c/td\u003e\n\u003ctd data-label=\"Observação\"\u003eA forma de exibição pode variar conforme a versão\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Comando\"\u003e\u003ccode\u003e/compact\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Finalidade\"\u003eResumir a conversa atual para liberar espaço no contexto\u003c/td\u003e\n\u003ctd data-label=\"Observação\"\u003eDetalhes podem ser condensados durante o processo de resumo\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Comando\"\u003e\u003ccode\u003e/clear\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Finalidade\"\u003eApagar o histórico da conversa atual e iniciar uma nova\u003c/td\u003e\n\u003ctd data-label=\"Observação\"\u003ePrimeiro, registre em um documento as decisões necessárias e o estado do trabalho\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eNão existe um critério universal segundo o qual a qualidade das respostas necessariamente diminui quando o contexto ultrapassa determinada porcentagem. Claude Code também pode realizar compactação automática, e a qualidade é afetada não apenas pela quantidade de informações incluídas, mas também por sua relevância, redundância e possíveis conflitos.\u003c/p\u003e\n\u003cp\u003eConsidere organizar o contexto quando notar os seguintes sinais.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eDeixa repetidamente de considerar requisitos que já foram alterados.\u003c/li\u003e\n\u003cli\u003eConfunde um estado antigo dos arquivos com o estado atual.\u003c/li\u003e\n\u003cli\u003eMistura condições de funcionalidades diferentes.\u003c/li\u003e\n\u003cli\u003eLê repetidamente o mesmo arquivo sem necessidade.\u003c/li\u003e\n\u003cli\u003eA conversa e a saída das ferramentas ficaram excessivamente longas.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eNão é necessário executar \u003ccode\u003e/clear\u003c/code\u003e obrigatoriamente sempre que uma funcionalidade for concluída. Em vez disso, registre as decisões concluídas, os itens pendentes e os resultados dos testes na documentação do projeto ou no histórico de trabalho antes de iniciar uma nova sessão, reduzindo assim a perda de informações.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#gerenciamento-das-instru%C3%A7%C3%B5es-do-projeto-com-claudemd\" class=\"anchor\" id=\"gerenciamento-das-instruções-do-projeto-com-claudemd\"\u003e\u003c/a\u003eGerenciamento das instruções do projeto com CLAUDE.md\u003c/h2\u003e\n\u003cp\u003eO nome do arquivo geralmente é escrito como \u003ccode\u003eCLAUDE.md\u003c/code\u003e, incluindo letras maiúsculas. Esse arquivo não é uma memória permanente do Claude, mas um documento persistente de instruções que Claude Code consulta no projeto. Incluí-lo no repositório permite compartilhar as instruções com a equipe, mas informações confidenciais não devem ser registradas nele.\u003c/p\u003e\n\u003cp\u003eÉ possível usar o comando \u003ccode\u003e/init\u003c/code\u003e para analisar o projeto e começar a criar o \u003ccode\u003eCLAUDE.md\u003c/code\u003e inicial, mas o resultado deve obrigatoriamente ser revisado por uma pessoa.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#conte%C3%BAdo-recomendado\" class=\"anchor\" id=\"conteúdo-recomendado\"\u003e\u003c/a\u003eConteúdo recomendado\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eObjetivo e principais funcionalidades do projeto\u003c/li\u003e\n\u003cli\u003eLinguagens, frameworks e versões de runtime utilizados\u003c/li\u003e\n\u003cli\u003eFunção dos diretórios e módulos importantes\u003c/li\u003e\n\u003cli\u003eComandos de instalação, servidor de desenvolvimento, teste, lint e build\u003c/li\u003e\n\u003cli\u003eEstilo de código e convenções de nomenclatura\u003c/li\u003e\n\u003cli\u003eArquivos que não devem ser modificados ou código gerado\u003c/li\u003e\n\u003cli\u003ePrincípios de segurança e tratamento de dados pessoais\u003c/li\u003e\n\u003cli\u003eCritérios de conclusão das tarefas e procedimento de validação\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eExemplo:\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e# Project instructions\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Stack\n\u003c/span\u003e\u003cspan\u003e- Usamos TypeScript e Node.js.\n\u003c/span\u003e\u003cspan\u003e- O gerenciador de pacotes é o pnpm.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Commands\n\u003c/span\u003e\u003cspan\u003e- Teste: \u003c/span\u003e\u003cspan\u003e`pnpm test`\n\u003c/span\u003e\u003cspan\u003e- Lint: \u003c/span\u003e\u003cspan\u003e`pnpm lint`\n\u003c/span\u003e\u003cspan\u003e- Build: \u003c/span\u003e\u003cspan\u003e`pnpm build`\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e## Rules\n\u003c/span\u003e\u003cspan\u003e- Não leia nem faça commit do \u003c/span\u003e\u003cspan\u003e`.env`\u003c/span\u003e\u003cspan\u003e e de credenciais reais.\n\u003c/span\u003e\u003cspan\u003e- Antes de alterar o formato de resposta de uma API pública, apresente primeiro um plano.\n\u003c/span\u003e\u003cspan\u003e- Adicione testes relacionados às alterações de funcionalidades.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eNão existe um limite máximo oficial de 200 linhas para o \u003ccode\u003eCLAUDE.md\u003c/code\u003e. No entanto, instruções longas demais podem consumir contexto e criar conflitos entre regras, portanto é mais prático mantê-las curtas e específicas. Separe explicações detalhadas de design em documentos próprios e indique os caminhos necessários.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#procedimento-de-trabalho-recomendado\" class=\"anchor\" id=\"procedimento-de-trabalho-recomendado\"\u003e\u003c/a\u003eProcedimento de trabalho recomendado\u003c/h2\u003e\n\u003cp\u003eO procedimento básico para aumentar simultaneamente a segurança e a qualidade dos resultados é o seguinte.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eVerifique se o estado do Git está limpo e crie um backup ou commit.\u003c/li\u003e\n\u003cli\u003eExecute Claude Code na raiz do repositório.\u003c/li\u003e\n\u003cli\u003eVerifique o \u003ccode\u003eCLAUDE.md\u003c/code\u003e e a documentação existente.\u003c/li\u003e\n\u003cli\u003eNo modo Plan, receba o objetivo, os arquivos que serão modificados e o plano de testes.\u003c/li\u003e\n\u003cli\u003eDivida tarefas grandes em pequenas unidades que possam ser revisadas.\u003c/li\u003e\n\u003cli\u003eImplemente uma unidade por vez no modo Default ou Accept Edits.\u003c/li\u003e\n\u003cli\u003eRevise pessoalmente comandos de instalação, exclusão, implantação e alteração de dados.\u003c/li\u003e\n\u003cli\u003eVerifique testes, lint, checagem de tipos e o \u003ccode\u003egit diff\u003c/code\u003e.\u003c/li\u003e\n\u003cli\u003eDocumente o estado de conclusão e os problemas restantes.\u003c/li\u003e\n\u003cli\u003eSe a próxima tarefa não estiver relacionada à conversa anterior, inicie uma nova sessão com \u003ccode\u003e/clear\u003c/code\u003e.\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch2\u003e\n\u003ca href=\"#checklist-de-seguran%C3%A7a\" class=\"anchor\" id=\"checklist-de-segurança\"\u003e\u003c/a\u003eChecklist de segurança\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003eEvite que \u003ccode\u003e.env\u003c/code\u003e, chaves de API, certificados e dados de clientes sejam expostos em prompts ou no repositório.\u003c/li\u003e\n\u003cli\u003eNão faça experimentos diretamente em servidores e bancos de dados de produção.\u003c/li\u003e\n\u003cli\u003eLeia comandos de shell ou scripts de instalação de origem desconhecida antes de executá-los.\u003c/li\u003e\n\u003cli\u003eMesmo no código escrito pelo Claude, revise dependências, licenças, vulnerabilidades de segurança e testes.\u003c/li\u003e\n\u003cli\u003eEm tarefas importantes, aplique o princípio do menor privilégio e use um ambiente de desenvolvimento isolado.\u003c/li\u003e\n\u003cli\u003eVerifique alterações geradas automaticamente com o Git diff e mantenha a responsabilidade final com uma pessoa.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eClaude Code pode reduzir significativamente o tempo do processo de desenvolvimento, mas não é um mecanismo automático que garanta a precisão e a segurança dos resultados. A forma mais confiável de usá-lo é combinar instruções claras, permissões limitadas, pequenas unidades de alteração, testes automatizados e revisão humana.\u003c/p\u003e\n","tags":["Claude Code","Anthropic","Programação com IA","Ferramentas de desenvolvimento","CLI"],"faqs":[{"question":"É absolutamente necessário ter o VS Code para usar o Claude Code?","answer":"Não. Usar o terminal integrado do VS Code é conveniente, mas não é um requisito. Se você tiver um sistema operacional e um ambiente de terminal compatíveis, conforme a documentação oficial, poderá executar `claude` no diretório do projeto."},{"question":"Qual é a maior diferença entre o Claude na web e o Claude Code?","answer":"Enquanto o Claude na web oferece principalmente conversas e respostas sobre código, o Claude Code pode ler e modificar os arquivos reais do projeto e executar ferramentas de terminal dentro do escopo autorizado. Isso aumenta a produtividade, mas exige um gerenciamento cuidadoso das permissões de arquivos e comandos."},{"question":"Com qual modo de permissão os iniciantes devem começar?","answer":"Um fluxo seguro é primeiro revisar o plano de alterações e os arquivos de destino no modo Plan e depois implementar no modo Default ou Accept Edits. É melhor não aprovar automaticamente tarefas como instalação de pacotes, exclusão de arquivos e alterações no banco de dados."},{"question":"O modo Don't Ask executa todas as tarefas automaticamente?","answer":"Não. Em geral, Don't Ask é uma política que rejeita tarefas não autorizadas previamente em vez de perguntar ao usuário. Ele deve ser diferenciado de Bypass Permissions, que ignora todas as verificações de permissão."},{"question":"Como alterar o modelo no Claude Code?","answer":"Em uma sessão interativa, digite `/model` para verificar e selecionar os modelos disponíveis para a conta e o ambiente atuais. Como as versões e os aliases dos modelos podem mudar, use o menu atual como referência, em vez de listas antigas."},{"question":"Usar o Sonnet sempre resulta no menor custo?","answer":"Nem sempre. O custo varia não apenas de acordo com o preço do modelo, mas também com o contexto de entrada, o tamanho da saída, o número de novas tentativas, o uso de cache e os métodos de autenticação e pagamento. Para tarefas simples, um modelo mais econômico pode ser vantajoso, mas, em tarefas difíceis, um modelo de alto desempenho também pode reduzir o custo total ao diminuir o retrabalho."},{"question":"Qual é a diferença entre /clear e /compact?","answer":"`/clear` é usado para apagar o histórico da conversa atual e começar como se fosse uma nova sessão. `/compact` resume a conversa existente para liberar espaço de contexto, mas alguns detalhes podem ser condensados durante o processo de resumo."},{"question":"A qualidade das respostas necessariamente piora quando o contexto ultrapassa 80%?","answer":"Não existe um limiar universal desse tipo. Além da porcentagem de uso, a qualidade é afetada pela relevância, repetição e conflito das informações, bem como pelo tamanho das saídas das ferramentas. É razoável verificar o estado com `/context` e fazer uma limpeza quando surgirem sinais como confusão entre requisitos antigos."},{"question":"Qual é o nome de arquivo correto: claude.md ou CLAUDE.md?","answer":"O arquivo de instruções do projeto é grafado como `CLAUDE.md` na documentação oficial. Como alguns sistemas operacionais e ferramentas diferenciam maiúsculas de minúsculas, é mais seguro usar exatamente a grafia oficial."},{"question":"O CLAUDE.md deve ter no máximo 200 linhas?","answer":"Não existe um limite máximo oficial de 200 linhas. No entanto, instruções longas usam mais contexto e podem causar conflitos entre regras. Por isso, é recomendável escrever de forma concisa os principais comandos e restrições e separar as explicações detalhadas em outro documento."},{"question":"Posso inserir chaves de API ou senhas no CLAUDE.md?","answer":"Não. Como o CLAUDE.md pode ser enviado ao repositório e compartilhado com a equipe, não se devem registrar nele credenciais reais, dados de clientes ou chaves secretas. Informações confidenciais devem ser gerenciadas por meio de variáveis de ambiente ou sistemas de gerenciamento de segredos aprovados pela organização."},{"question":"Quando devo usar Bypass Permissions?","answer":"Essa opção deve ser considerada com cautela apenas em ambientes controlados, como contêineres isolados ou sandboxes descartáveis, nos quais seja possível limitar os danos causados pela ignorância das permissões. É recomendável não usá-la como modo padrão em computadores pessoais, repositórios importantes ou ambientes de produção."}],"sources":[{"url":"https://code.claude.com/docs/en/overview","title":"Visão geral do Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/setup","title":"Configuração do Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/permissions","title":"Permissões do Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/model-config","title":"Configuração do modelo do Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/costs","title":"Custos do Claude Code","type":"source"},{"url":"https://code.claude.com/docs/en/memory","title":"Memória do Claude Code e CLAUDE.md","type":"source"},{"url":"https://code.claude.com/docs/en/interactive-mode","title":"Modo interativo do Claude Code","type":"source"}],"images":[{"id":617,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ0NCwicHVyIjoiYmxvYl9pZCJ9fQ==--d808896af034f2719d1a1a65b061553a991d3196/ai-572421ed.webp","is_representative":true,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"코드가 표시된 노트북과 파일 트리, 권한 방패, 연결된 작업 흐름을 그린 일러스트","caption":"코드 작업에서 파일, 권한, 컨텍스트가 연결되는 구조를 시각화합니다.","description":null},"en":{"alt":"Illustration of a coding laptop, file tree, permission shield, and connected workflow","caption":"The diagram visualizes how files, permissions, and context connect in a coding workflow.","description":null},"ja":{"alt":"コード画面のノートPC、ファイルツリー、権限シールド、連携ワークフローのイラスト","caption":"コーディング作業でファイル、権限、コンテキストが連携する仕組みを示しています。","description":null},"es":{"alt":"Ilustración de un portátil con código, árbol de archivos, escudo de permisos y flujo conectado","caption":"El diagrama muestra cómo se conectan archivos, permisos y contexto en un flujo de programación.","description":null},"id":{"alt":"Ilustrasi laptop berkode, pohon file, perisai izin, dan alur kerja yang terhubung","caption":"Diagram ini memvisualisasikan hubungan file, izin, dan konteks dalam alur kerja pemrograman.","description":null},"pt":{"alt":"Ilustração de notebook com código, árvore de arquivos, escudo de permissões e fluxo conectado","caption":"O diagrama mostra como arquivos, permissões e contexto se conectam em um fluxo de programação.","description":null},"zh-hant":{"alt":"顯示程式碼的筆電、檔案樹、權限盾牌與連接工作流程的插圖","caption":"此圖呈現程式開發流程中檔案、權限與上下文的連結方式。","description":null},"de":{"alt":"Illustration eines Laptops mit Code, Dateibaum, Berechtigungsschild und vernetztem Arbeitsablauf","caption":"Die Grafik zeigt, wie Dateien, Berechtigungen und Kontext in einem Programmierablauf verbunden sind.","description":null}}},{"id":618,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6NzQ1MCwicHVyIjoiYmxvYl9pZCJ9fQ==--e073adddcaf8ad6bf81bc0a0b0ca1d385d6d6a38/ai-c02b920d.webp","is_representative":false,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"중앙 서버에 코드, 권한 잠금, 워크플로, 문서, 데이터베이스, 클라우드가 연결된 그림","caption":"Claude Code의 코드 실행, 권한, 컨텍스트와 데이터 연결 구조를 시각화한 그림입니다.","description":null},"en":{"alt":"Central server linked to code, permission lock, workflow, documents, databases, and cloud services","caption":"The illustration visualizes how Claude Code connects execution, permissions, context, and data.","description":null},"ja":{"alt":"中央サーバーにコード、権限ロック、ワークフロー、文書、データベース、クラウドが接続された図","caption":"Claude Codeにおけるコード実行、権限、コンテキスト、データの連携を表しています。","description":null},"es":{"alt":"Servidor central conectado con código, permisos, flujos, documentos, bases de datos y nube","caption":"La ilustración representa la conexión entre ejecución, permisos, contexto y datos en Claude Code.","description":null},"id":{"alt":"Server pusat terhubung ke kode, kunci izin, alur kerja, dokumen, basis data, dan cloud","caption":"Ilustrasi ini menunjukkan hubungan eksekusi, izin, konteks, dan data dalam Claude Code.","description":null},"pt":{"alt":"Servidor central ligado a código, bloqueio de permissões, fluxos, documentos, bancos de dados e nuvem","caption":"A ilustração mostra a conexão entre execução, permissões, contexto e dados no Claude Code.","description":null},"zh-hant":{"alt":"中央伺服器連接程式碼、權限鎖、工作流程、文件、資料庫與雲端服務","caption":"此圖呈現 Claude Code 中程式執行、權限、上下文與資料的連接關係。","description":null},"de":{"alt":"Zentraler Server mit Code, Zugriffssperre, Abläufen, Dokumenten, Datenbanken und Cloud-Diensten","caption":"Die Grafik zeigt das Zusammenspiel von Ausführung, Berechtigungen, Kontext und Daten in Claude Code.","description":null}}}],"published_at":"2026-08-13T12:12:59+09:00","updated_at":"2026-08-13T12:12:59+09:00","license":"cc_by","translation_status":"reviewed","available_locales":["ko","en","ja","es"],"data_locales":["ko","en","ja","es","id","pt","zh-hant","de"],"url":"https://injoys.com/en/articles/claude-code-setup-permissions-models-context-guide"}