Gerenciamento de Identidade e Acesso

​

Métodos de autenticação

Configurar o Claude Code requer acesso aos modelos da Anthropic. Para equipes, você pode configurar o acesso ao Claude Code de uma das três maneiras:

• API da Anthropic via Console da Anthropic
• Amazon Bedrock
• Google Vertex AI

​

Autenticação da API da Anthropic

Para configurar o acesso ao Claude Code para sua equipe via API da Anthropic:

1. Use sua conta existente do Console da Anthropic ou crie uma nova conta do Console da Anthropic
2. Você pode adicionar usuários através de qualquer um dos métodos abaixo:
   • Convide usuários em massa de dentro do Console (Console -> Configurações -> Membros -> Convidar)
   • Configure SSO
3. Ao convidar usuários, eles precisam de uma das seguintes funções:
   • A função “Claude Code” significa que os usuários só podem criar chaves de API do Claude Code
   • A função “Developer” significa que os usuários podem criar qualquer tipo de chave de API
4. Cada usuário convidado precisa completar estas etapas:
   • Aceitar o convite do Console
   • Verificar requisitos do sistema
   • Instalar Claude Code
   • Fazer login com as credenciais da conta do Console

​

Autenticação do provedor de nuvem

Para configurar o acesso ao Claude Code para sua equipe via Bedrock ou Vertex:

1. Siga a documentação do Bedrock ou documentação do Vertex
2. Distribua as variáveis de ambiente e instruções para gerar credenciais de nuvem para seus usuários. Leia mais sobre como gerenciar configuração aqui.
3. Os usuários podem instalar Claude Code

​

Controle de acesso e permissões

Suportamos permissões granulares para que você possa especificar exatamente o que o agente tem permissão para fazer (ex: executar testes, executar linter) e o que não tem permissão para fazer (ex: atualizar infraestrutura de nuvem). Essas configurações de permissão podem ser incluídas no controle de versão e distribuídas para todos os desenvolvedores em sua organização, bem como personalizadas por desenvolvedores individuais.

​

Sistema de permissões

O Claude Code usa um sistema de permissões em camadas para equilibrar poder e segurança:

Tipo de Ferramenta	Exemplo	Aprovação Necessária	Comportamento “Sim, não pergunte novamente”
Somente leitura	Leituras de arquivo, LS, Grep	Não	N/A
Comandos Bash	Execução de shell	Sim	Permanentemente por diretório de projeto e comando
Modificação de Arquivo	Editar/escrever arquivos	Sim	Até o fim da sessão

​

Configurando permissões

Você pode visualizar e gerenciar as permissões de ferramentas do Claude Code com /permissions. Esta interface lista todas as regras de permissão e o arquivo settings.json de onde elas são originadas.

• Regras Allow permitirão que o Claude Code use a ferramenta especificada sem aprovação manual adicional.
• Regras Ask perguntarão ao usuário para confirmação sempre que o Claude Code tentar usar a ferramenta especificada. Regras Ask têm precedência sobre regras allow.
• Regras Deny impedirão que o Claude Code use a ferramenta especificada. Regras Deny têm precedência sobre regras allow e ask.
• Diretórios adicionais estendem o acesso de arquivo do Claude para diretórios além do diretório de trabalho inicial.
• Modo padrão controla o comportamento de permissão do Claude ao encontrar novas solicitações.

Regras de permissão usam o formato: Tool ou Tool(especificador-opcional)

Uma regra que é apenas o nome da ferramenta corresponde a qualquer uso dessa ferramenta. Por exemplo, adicionar Bash à lista de regras allow permitiria que o Claude Code use a ferramenta Bash sem exigir aprovação do usuário.

​

Modos de permissão

O Claude Code suporta vários modos de permissão que podem ser definidos como defaultMode em arquivos de configurações:

Modo	Descrição
default	Comportamento padrão - solicita permissão no primeiro uso de cada ferramenta
acceptEdits	Aceita automaticamente permissões de edição de arquivo para a sessão
plan	Modo Plano - Claude pode analisar mas não modificar arquivos ou executar comandos
bypassPermissions	Pula todos os prompts de permissão (requer ambiente seguro - veja aviso abaixo)

​

Diretórios de trabalho

Por padrão, Claude tem acesso a arquivos no diretório onde foi iniciado. Você pode estender este acesso:

• Durante a inicialização: Use o argumento CLI --add-dir <path>
• Durante a sessão: Use o comando slash /add-dir
• Configuração persistente: Adicione a additionalDirectories em arquivos de configurações

Arquivos em diretórios adicionais seguem as mesmas regras de permissão que o diretório de trabalho original - eles se tornam legíveis sem prompts, e permissões de edição de arquivo seguem o modo de permissão atual.

​

Regras de permissão específicas de ferramenta

Algumas ferramentas suportam controles de permissão mais granulares:

Bash

• Bash(npm run build) Corresponde ao comando Bash exato npm run build
• Bash(npm run test:*) Corresponde a comandos Bash que começam com npm run test
• Bash(curl http://site.com/:*) Corresponde a comandos curl que começam exatamente com curl http://site.com/

Read & Edit

Regras Edit se aplicam a todas as ferramentas integradas que editam arquivos. Claude fará um esforço de melhor tentativa para aplicar regras Read a todas as ferramentas integradas que leem arquivos como Grep, Glob e LS.

Regras Read & Edit seguem a especificação gitignore com quatro tipos distintos de padrão:

Padrão	Significado	Exemplo	Corresponde
//path	Caminho absoluto da raiz do sistema de arquivos	Read(//Users/alice/secrets/**)	/Users/alice/secrets/**
~/path	Caminho do diretório home	Read(~/Documents/*.pdf)	/Users/alice/Documents/*.pdf
/path	Caminho relativo ao arquivo de configurações	Edit(/src/**/*.ts)	<caminho do arquivo de configurações>/src/**/*.ts
path ou ./path	Caminho relativo ao diretório atual	Read(*.env)	<cwd>/*.env

• Edit(/docs/**) - Edições em <projeto>/docs/ (NÃO /docs/!)
• Read(~/.zshrc) - Lê o .zshrc do seu diretório home
• Edit(//tmp/scratch.txt) - Edita o caminho absoluto /tmp/scratch.txt
• Read(src/**) - Lê de <diretório-atual>/src/

WebFetch

• WebFetch(domain:example.com) Corresponde a solicitações de fetch para example.com

MCP

• mcp__puppeteer Corresponde a qualquer ferramenta fornecida pelo servidor puppeteer (nome configurado no Claude Code)
• mcp__puppeteer__puppeteer_navigate Corresponde à ferramenta puppeteer_navigate fornecida pelo servidor puppeteer

​

Controle de permissão adicional com hooks

Hooks do Claude Code fornecem uma maneira de registrar comandos shell personalizados para realizar avaliação de permissão em tempo de execução. Quando o Claude Code faz uma chamada de ferramenta, hooks PreToolUse executam antes do sistema de permissões executar, e a saída do hook pode determinar se deve aprovar ou negar a chamada da ferramenta no lugar do sistema de permissões.

​

Configurações de política gerenciada empresarial

Para implantações empresariais do Claude Code, suportamos configurações de política gerenciada empresarial que têm precedência sobre configurações de usuário e projeto. Isso permite que administradores de sistema imponham políticas de segurança que os usuários não podem sobrescrever.

Administradores de sistema podem implantar políticas para:

• macOS: /Library/Application Support/ClaudeCode/managed-settings.json
• Linux e WSL: /etc/claude-code/managed-settings.json
• Windows: C:\ProgramData\ClaudeCode\managed-settings.json

Esses arquivos de política seguem o mesmo formato que arquivos de configurações regulares mas não podem ser sobrescritos por configurações de usuário ou projeto. Isso garante políticas de segurança consistentes em toda sua organização.

​

Precedência de configurações

Quando múltiplas fontes de configurações existem, elas são aplicadas na seguinte ordem (precedência mais alta para mais baixa):

1. Políticas empresariais
2. Argumentos de linha de comando
3. Configurações de projeto local (.claude/settings.local.json)
4. Configurações de projeto compartilhado (.claude/settings.json)
5. Configurações de usuário (~/.claude/settings.json)

Esta hierarquia garante que políticas organizacionais sejam sempre impostas enquanto ainda permite flexibilidade nos níveis de projeto e usuário onde apropriado.

​

Gerenciamento de credenciais

O Claude Code gerencia com segurança suas credenciais de autenticação:

• Local de armazenamento: No macOS, chaves de API, tokens OAuth e outras credenciais são armazenadas no Keychain criptografado do macOS.
• Tipos de autenticação suportados: Credenciais Claude.ai, credenciais da API Anthropic, Bedrock Auth e Vertex Auth.
• Scripts de credencial personalizados: A configuração apiKeyHelper pode ser configurada para executar um script shell que retorna uma chave de API.
• Intervalos de atualização: Por padrão, apiKeyHelper é chamado após 5 minutos ou em resposta HTTP 401. Defina a variável de ambiente CLAUDE_CODE_API_KEY_HELPER_TTL_MS para intervalos de atualização personalizados.