Todas as configurações

Índice de configurações

Modelo e respostas

advisorModel

• Escopo: Any file
• Tipo: string, um dos aliases "fable", "opus" ou "sonnet", que correspondem à versão padrão atual do Claude Code daquela família de modelos, ou um ID de modelo completo, como "claude-opus-5-5"
• Padrão: não definido, então o advisor fica desativado
• Substituições por sessão: --advisor tem precedência sobre esta chave para uma sessão. CLAUDE_CODE_DISABLE_ADVISOR_TOOL desativa o advisor, e esta chave não pode reativá-lo

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

• Escopo: Any file
• Tipo: Boolean
  • true: sem efeito; o pensamento já está ativado
  • false: o Claude Code desativa o pensamento estendido em todas as sessões
• Padrão: não definido, então o pensamento fica ativado para modelos que o suportam
• Substituições por sessão: MAX_THINKING_TOKENS tem precedência sobre esta chave para uma sessão: 0 desativa o pensamento, sob os mesmos limites de modelo e provedor que false, e um valor positivo ativa o pensamento mesmo quando esta chave é false. Em modelos com raciocínio adaptativo, o número em si é ignorado

{
  "alwaysThinkingEnabled": false
}

availableModels

• Escopo: Any file. Implante-a em configurações gerenciadas para aplicá-la a uma organização.
• Tipo: array de aliases ou IDs de modelo
• Padrão: não definido, então todos os modelos estão disponíveis

{
  "availableModels": ["sonnet", "haiku"]
}

availableModelsMatch

• Escopo: Managed. O Claude Code ignora a chave nas configurações de usuário, de projeto e locais e em --settings, com um aviso
• Tipo: string, um de:
  • "prefix": uma entrada de ID de modelo permite sua versão e qualquer ID de modelo que a estenda com outro segmento
  • "exact": uma entrada de ID de modelo permite apenas a versão que ela nomeia, então "claude-opus-5" permite o Opus 5, mas não claude-opus-5-5. Uma entrada como "claude-opus-4-5" também permite seu ID de modelo datado da Anthropic claude-opus-4-5-20251101. Um alias de família como "opus" ainda permite a família inteira, e as entradas best, opusplan e default são ignoradas
• Padrão: "prefix"

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

deniedModels

• Escopo: Managed. O Claude Code ignora a chave nas configurações de usuário, de projeto e locais e em --settings, com um aviso
• Tipo: array de aliases ou IDs de modelo
  • Um alias de família como "opus" bloqueia todos os modelos daquela família
  • Um ID de modelo como "claude-opus-5-5" bloqueia essa versão em todas as grafias, incluindo IDs datados e específicos de provedores
  • Um ID de modelo sem versão secundária, como "claude-opus-5", também bloqueia versões secundárias posteriores, como o Opus 5.5. Escreva "claude-opus-5-0" para bloquear apenas o Opus 5
  • As entradas best, opusplan e default são ignoradas
• Padrão: não definido, então nenhum modelo é bloqueado

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

effortLevel

• Escopo: Any file
• Tipo: string, um de:
  • "low": o mínimo de raciocínio, para tarefas curtas, delimitadas e sensíveis à latência que não dependem de inteligência
  • "medium": reduz o uso de tokens para trabalhos sensíveis a custo que podem abrir mão de alguma inteligência
  • "high": equilibra uso de tokens e inteligência
  • "xhigh": raciocínio mais profundo com maior gasto de tokens
• Padrão: não definido
• Substituições por sessão: --effort tem precedência sobre esta chave para uma sessão, e CLAUDE_CODE_EFFORT_LEVEL tem precedência sobre ambos

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

• Escopo: Any file
• Tipo: Boolean
  • true: quando Default seria resolvida para um modelo fora de availableModels, o Claude Code a resolve para o primeiro modelo disponível na lista
  • false: esta chave não altera como Default é resolvida
• Padrão: false

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

fallbackModel

• Escopo: Any file
• Tipo: array de aliases ou IDs de modelo; "default" se expande para o modelo padrão
• Padrão: não definido, então uma requisição com falha não é tentada novamente em outro modelo
• Substituições por sessão: --fallback-model tem precedência sobre esta chave para uma sessão

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

fastMode

• Escopo: Any file
• Tipo: Boolean
  • true: o Claude Code ativa o modo rápido em sessões onde ele está disponível. No Fable 5.2, você também precisa executar /fast enquanto usa o Fable 5.2
  • false: o modo rápido permanece desativado
• Padrão: não definido, então o modo rápido fica desativado
• Substituições por sessão: CLAUDE_CODE_DISABLE_FAST_MODE desativa o modo rápido para uma sessão, e esta chave não pode reativá-lo

{
  "fastMode": true
}

fastModePerSessionOptIn

• Escopo: Any file
• Tipo: Boolean
  • true: um fastMode: true salvo não ativa mais o modo rápido no início da sessão, então cada pessoa executa /fast em cada sessão em que quiser usá-lo; um fastMode: true passado com --settings ainda vale para aquela sessão, a menos que as configurações gerenciadas definam esta chave
  • false: um fastMode: true salvo funciona conforme descrito em fastMode
• Padrão: false

{
  "fastModePerSessionOptIn": true
}

language

• Escopo: Any file
• Tipo: string, qualquer nome de idioma, como "japanese", "spanish" ou "french"; o Claude Code não o valida
• Padrão: não definido; os títulos de sessão então seguem o idioma da sua conversa

{
  "language": "japanese"
}

maxEffortLevel

• Escopo: Any file. Implante-a em configurações gerenciadas para aplicá-la a uma organização. Quando vários escopos definem um limite, o mais baixo se aplica, então um limite definido em um escopo não pode ser aumentado a partir de outro
• Tipo: string, um de "low", "medium", "high", "xhigh" ou "max". Um valor "max" não define limite
• Padrão: não definido, então nenhum limite se aplica
• Limites por modelo: adicione maxEffortLevel à entrada de um modelo em modelSettings. Essa entrada substitui esta chave para o modelo apenas dentro da fonte de configurações que define ambas, como suas configurações de usuário ou uma fonte gerenciada. Defina "max" ali para isentar o modelo do limite daquela fonte; o Claude Code ainda aplica limites de outras fontes

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

model

• Escopo: Any file
• Tipo: string, um alias de modelo ou ID de modelo completo
• Padrão: não definido, então o Claude Code usa o modelo padrão da sua conta
• Substituições por sessão: --model tem precedência sobre ANTHROPIC_MODEL, e ambos têm precedência sobre esta chave para uma sessão, inclusive sobre um model gerenciado; uma lista availableModels ainda se aplica à escolha

{
  "model": "claude-sonnet-5"
}

modelOverrides

• Escopo: Any file
• Tipo: objeto que mapeia ID de modelo para ID de modelo do provedor
• Padrão: não definido

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

modelPicker

• Escopo: User or managed. O Claude Code lê a chave das configurações gerenciadas, de --settings e das configurações de usuário, e a ignora nas configurações de projeto e locais para que um repositório que você clona não possa renomear o seletor. A fonte de maior precedência dentre essas três que define a chave fornece a lista inteira, e o Claude Code nunca combina listas de duas fontes.
• Tipo: objeto com um array options de linhas e um Boolean opcional replaceBuiltInOptions
• Padrão: não definido, então o seletor mostra a lista integrada

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Campos de modelPicker

• Removida: uma linha que o Claude Code não consegue atender, como um modelo descontinuado ou um modelo ao qual sua organização não tem acesso
• Desabilitada: uma linha que você ainda não pode selecionar, mostrada com o motivo
• Nenhuma linha restante: o Claude Code mantém a lista integrada, filtrada pela allowlist como de costume

modelPricing

• Escopo: Managed. Implante a chave por meio de configurações gerenciadas pelo servidor, uma política de MDM, um arquivo managed-settings.json ou um auxiliar de política. O Claude Code a ignora nas configurações de usuário, de projeto e locais, em --settings e, no Windows, no registro HKCU gravável pelo usuário. Com configurações gerenciadas pelo servidor, cada sessão informa custos pelo preço de tabela até que a busca de configurações daquela sessão tenha confirmado a configuração. Um aplicativo host que incorpora o Claude Code e define CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST pode fornecer sua própria tabela por meio da opção managedSettings do SDK, que o Claude Code usa apenas quando nenhuma fonte gerenciada define a chave e apenas no Claude Code v2.1.246 ou posterior.
• Tipo: objeto com um multiplier opcional e um mapa overrides opcional
• Padrão: não definido, então o Claude Code informa o preço de tabela, a menos que um aplicativo host forneça uma tabela

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

Campos de modelPricing

A quais modelos uma linha de modelPricing se aplica

• O ID de um modelo integrado: uma chave que o próprio Claude Code usa para um modelo integrado, seja o próprio ID do modelo, como claude-sonnet-4-6, ou seu ID no Bedrock, no Agent Platform ou no Foundry. O Claude Code aplica a linha a todos os IDs de snapshot datados e IDs específicos de provedores daquele modelo.
• Qualquer outra chave: uma chave que não é o ID de um modelo integrado, como um alias de modelo de gateway. O Claude Code aplica a linha apenas àquele ID. Quando um ID de modelo corresponde exatamente a uma das suas chaves e também se enquadra em uma linha cuja chave é o ID de um modelo integrado, o Claude Code usa a correspondência exata.
• Um perfil de inferência de aplicativo do Bedrock: depois que o Claude Code resolve o perfil para o modelo para o qual ele roteia, por meio do seu mapa modelOverrides ou da consulta bedrock:GetInferenceProfile, o Claude Code aplica a linha daquele modelo ao perfil.

modelSettings

• Escopo: Any file
• Tipo: objeto que mapeia um nome de modelo para um objeto com qualquer um destes campos:
  • effortLevel: um de "low", "medium", "high" ou "xhigh"
  • maxEffortLevel: o nível de esforço mais alto com que o modelo pode ser executado
  • autoCompactWindow: um número de tokens de 100000 a 1000000, ou "auto" para a janela ajustada para o modelo. /autocompact salva aqui. Para aquele modelo, o valor tem precedência sobre um autoCompactWindow de nível superior no mesmo arquivo de configurações. Requer Claude Code v2.1.288 ou posterior
• Padrão: não definido

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

outputStyle

• Escopo: Any file
• Tipo: string, o nome de um estilo de saída integrado ou personalizado
• Padrão: não definido, então o Claude Code usa o estilo padrão

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

• Escopo: Any file
• Tipo: string, um de:
  • "5m": o cache dura cinco minutos
  • "1h": o cache dura uma hora
• Padrão: não definido, então cada requisição da conversa principal recebe sua duração padrão
• Substituições por sessão: FORCE_PROMPT_CACHING_5M tem precedência sobre todo o resto, depois CLAUDE_CODE_PROMPT_CACHE_TTL, depois esta chave e, por último, ENABLE_PROMPT_CACHING_1H

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

showThinkingSummaries

• Escopo: Any file
• Tipo: Boolean
  • true: você vê os resumos completos de pensamento ao expandir o pensamento com Ctrl+O
  • false: a API da Anthropic oculta os blocos de pensamento e o Claude Code mostra um stub recolhido
• Padrão: false

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

• Escopo: Any file
• Tipo: string, um de:
  • "5m": o cache dura cinco minutos
  • "1h": o cache dura uma hora
• Padrão: não definido, então cada uma dessas requisições recebe sua duração padrão
• Substituições por sessão: FORCE_PROMPT_CACHING_5M tem precedência sobre todo o resto, depois CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, depois esta chave, depois ENABLE_PROMPT_CACHING_1H, que solicita a duração de uma hora em todas as requisições. Para saber onde se posiciona o valor no frontmatter do próprio subagente, consulte Escolher o TTL você mesmo

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

• Escopo: Any file. Aparece em /config como Switch models when a message is flagged, com as opções Switch automatically e Ask each time.
• Tipo: Boolean
  • true: o Claude Code muda para o modelo de fallback e continua
  • false: em uma sessão interativa, o Claude Code pausa para que você possa escolher entre mudar e editar o prompt; onde nenhuma caixa de diálogo pode ser exibida, como em uma execução -p, a requisição sinalizada termina com um erro
• Padrão: não definido. O Claude Code muda automaticamente, embora possa perguntar primeiro em uma sessão interativa

{
  "switchModelsOnFlag": false
}

ultracode

• Escopo: Any file
• Tipo: Boolean
  • true: as sessões começam com o ultracode ativado quando os fluxos de trabalho dinâmicos estão habilitados para você e seu modelo suporta xhigh
  • false: as sessões começam com o ultracode desativado
• Padrão: não definido, então o ultracode fica desativado
• Substituições por sessão: /effort ultracode ativa o ultracode para uma sessão sem esta chave, e /effort ultracode off o desativa para uma sessão quando esta chave é true. A flag --effort ultracode também o ativa para uma sessão, com esforço xhigh

{
  "ultracode": true
}

Configurações de permissão

allowManagedPermissionRulesOnly

• O diretório .claude/ de um repositório
• Seus diretórios ~/.claude/skills/ e ~/.claude/commands/, incluindo skills sincronizadas do claude.ai
• Um diretório --add-dir
• Plugins declarados com um manifesto .claude-plugin dentro de ~/.claude/skills/ ou do .claude/skills/ do projeto
• Plugins carregados para apenas uma sessão, cujos ids terminam em @inline, quando todas estas condições se aplicam:
  • A sessão é uma sessão Code ou sessão Cowork, exceto uma sessão na nuvem, para a qual o próprio aplicativo Claude Desktop inicia Claude Code
  • Suas configurações gerenciadas definem a chave, não apenas as configurações pai de um host de incorporação
  • A sessão executa Claude Code v2.1.305 ou posterior

• Escopo: Managed
• Tipo: Booleano
  • true: as configurações gerenciadas se tornam a única fonte de regras de permissão
  • false: Claude Code aplica regras de permissão de arquivos de usuário, projeto, local e --settings além das gerenciadas
• Padrão: não definido, portanto Claude Code aplica regras de permissão de configurações de usuário, projeto e local e de --settings, além das gerenciadas

{
  "allowManagedPermissionRulesOnly": true
}

autoMode

• Escopo: User or managed
• Tipo: objeto com arrays environment, allow, soft_deny e hard_deny de regras em prosa, mais o Booleano classifyAllShell
• Padrão: não definido, portanto o classificador usa apenas suas regras integradas

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

autoMode.classifyAllShell

• Escopo: User or managed. Leia onde autoMode é lido.
• Tipo: Booleano
  • true: enquanto o modo automático está ativo, Claude Code envia cada comando Bash e PowerShell através do classificador e suspende suas regras de shell de permissão; fora do modo automático as regras ainda se aplicam
  • false: o modo automático suspende apenas regras de permissão que poderiam executar código arbitrário, como Bash(*) e Bash(python *); um comando que qualquer outra regra de permissão corresponde pula o classificador a menos que ele carregue domínios permitidos por comando, e cada outro comando de shell passa por ele
• Padrão: false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

disableAutoMode

• Escopo: Any file. Mais útil em configurações gerenciadas, onde os usuários não podem substituí-lo. Também aceito sob permissions como permissions.disableAutoMode.
• Tipo: a string "disable"
• Padrão: não definido

{
  "disableAutoMode": "disable"
}

permissions

• Escopo: Any file
• Tipo: objeto com allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, blockWritesOutsideWorkingDirectories, defaultMode, denyInsteadOfPrompting, disableBypassPermissionsMode e disableAutoMode
• Padrão: não definido

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

useAutoModeDuringPlan

• Escopo: User, local, or managed. Um repositório não pode desativá-lo para você.
  • Um false em qualquer um desses arquivos ou em --settings o desativa, a menos que você deixe esse arquivo de usuário ou local de fora com uma opção como --setting-sources. Ignorar um arquivo deixado de fora requer Claude Code v2.1.314 ou posterior
• Tipo: Booleano
  • true: o mesmo que não definido; quando o modo auto está disponível, o classificador revisa comandos de shell durante o planejamento
  • false: você obtém um prompt de permissão para cada comando fora do conjunto integrado somente leitura
• Padrão: true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

• Escopo: Any file
• Tipo: array de strings de regra de permissão
• Padrão: não definido
• Substituições por sessão: --allowedTools adiciona regras de permissão para uma sessão, e uma regra de bloqueio de qualquer arquivo de configurações ainda bloqueia uma ferramenta que ela nomeia

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

Sintaxe de regra de permissão

permissions.ask

• Escopo: Any file
• Tipo: array de strings de regra de permissão
• Padrão: não definido

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

permissions.deny

• Escopo: Any file
• Tipo: array de strings de regra de permissão
• Padrão: não definido
• Substituições por sessão: --disallowedTools adiciona regras de bloqueio para uma sessão ao lado desta chave

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

permissions.additionalDirectories

• Escopo: Any file, com limites no acesso de gravação do sandbox que as entradas de projeto e local concedem
• Tipo: array de caminhos de diretório
• Padrão: não definido
• Substituições por sessão: --add-dir e /add-dir adicionam diretórios para uma sessão ao lado desta chave

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

permissions.blockReadsOutsideWorkingDirectories

• Ações que nenhum modo aprova automaticamente cobre quando um comando de shell que lê tal caminho solicita a você
• Comandos em sandbox sob o bloqueio cobre o que um comando em sandbox pode ler

• Escopo: Any file. Um true em qualquer arquivo se aplica, portanto um repositório pode ativar o bloqueio para si mesmo, mas não pode levantar o seu.
• Tipo: Booleano
  • true: as ferramentas de arquivo de Claude recusam leituras fora dos diretórios de trabalho
  • false: o mesmo que não definido; o bloqueio ainda se aplica se outro arquivo definir true
• Padrão: não definido, portanto leituras fora dos diretórios de trabalho seguem seu modo de permissão

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

Comandos em sandbox sob o bloqueio

• O isolamento do sistema de arquivos está desativado através de sandbox.filesystem.disabled
• allowManagedReadPathsOnly está definido
• O caminho do diretório em que você iniciou Claude Code contém um caractere glob como *, ? ou [

• ~/.gitconfig
• Os arquivos config, ignore e attributes sob $XDG_CONFIG_HOME/git, que padrão para ~/.config/git
• Arquivos que sua configuração git global nomeia através de [include], [includeIf], core.excludesFile ou core.attributesFile

permissions.blockWritesOutsideWorkingDirectories

• Escopo: Any file. Um true em qualquer arquivo que a sessão carrega se aplica, portanto um repositório pode ativar o bloqueio para si mesmo, mas não pode levantar o seu. Em uma sessão na nuvem, Claude Code pode não aplicar a chave, porque as ferramentas de arquivo são executadas em um contêiner que é ele próprio o limite.
• Tipo: Booleano
  • true: ativa o bloqueio
  • false: o mesmo que não definido; o bloqueio ainda se aplica se outro arquivo definir true
• Padrão: não definido, portanto gravações fora dos diretórios de trabalho seguem seu modo de permissão. O bloqueio também fica ativo enquanto Claude Code não consegue ler o objeto permissions nas suas configurações gerenciadas.

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

O que o bloqueio de gravação recusa e o que permanece gravável

• Arquivos de configurações do Claude Code: Claude Code recusa essas gravações também dentro dos diretórios de trabalho, porque um arquivo de configurações pode levantar o bloqueio. Edite os arquivos de configurações você mesmo.
• Um diretório que apenas as configurações de repositório adicionam: um que additionalDirectories lista apenas em .claude/settings.json, ou em .claude/settings.local.json a menos que git relate esse arquivo como não rastreado
• O worktree de um subagente: as edições de arquivo de um subagente isolation: worktree são recusadas quando o seu worktree fica fora dos diretórios de trabalho
• Memória automática em um diretório que o repositório escolheu: um diretório que autoMemoryDirectory nomeia nas configurações de repositório

Permitir um diretório através do bloqueio de leitura ou gravação

permissions.defaultMode

• Escopo: Any file. auto e bypassPermissions não entram em vigor a partir de configurações de projeto ou local, portanto defina-os em ~/.claude/settings.json em vez disso. Antes da v2.1.257, bypassPermissions entrava em vigor a partir de qualquer arquivo. Para conversas que a extensão VS Code inicia, Claude Code lê apenas valores de usuário, gerenciados e --settings.
• Tipo: string, uma de:
  • "default": Claude Code executa apenas leituras sem perguntar
  • "acceptEdits": Claude Code também executa edições de arquivo e comandos comuns do sistema de arquivos como mkdir e mv sem perguntar
  • "plan": Claude Code lê e planeja, mas bloqueia edições até que você aprove um plano
  • "auto": Claude Code executa sem prompts rotineiros; antes de ações como comandos de shell e requisições de rede serem executadas, um classificador em segundo plano verifica se elas se alinham com sua solicitação
  • "dontAsk": Claude Code nega automaticamente cada chamada que de outra forma solicitaria, embora um mod que você instalou ainda possa aprovar algumas dessas chamadas. Leituras de arquivos dentro dos seus diretórios de trabalho, outras ações que não precisam de aprovação e ferramentas pré-aprovadas ainda são executadas, exceto leituras de caminhos de rede
  • "bypassPermissions": Claude Code executa tudo sem perguntar
  • "manual": um alias para "default"
• Padrão: não definido
• Substituições por sessão: --permission-mode e seu equivalente --dangerously-skip-permissions para bypassPermissions têm precedência sobre esta chave para uma sessão

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

permissions.denyInsteadOfPrompting

• Escopo: User or managed, e --settings. Um repositório não pode defini-lo para você.
• Tipo: Booleano
  • true: Claude Code nega chamadas que de outra forma solicitariam confirmação
  • false: o mesmo que não definido; as chamadas ainda são negadas se outra dessas fontes definir true
• Padrão: não definido, portanto uma chamada que precisa de aprovação solicita sua confirmação

{
  "permissions": {
    "defaultMode": "auto",
    "denyInsteadOfPrompting": true
  }
}

O que mais denyInsteadOfPrompting interrompe

• Ferramentas de pergunta e de plano: Claude Code deixa de fora AskUserQuestion, EnterPlanMode e ExitPlanMode, portanto uma sessão no modo de planejamento não pode sair dele por conta própria. Um colega de equipe em uma equipe de agentes mantém EnterPlanMode e ExitPlanMode
• Elicitação MCP: Claude Code cancela uma requisição de elicitação a menos que um hook Elicitation a responda
• Hosts de permissão: Claude Code não consulta seu callback canUseTool nem --permission-prompt-tool. Para aprovar chamadas a partir de código, responda a partir de um hook PermissionRequest. Algumas chamadas são negadas antes que qualquer hook seja consultado, como uma remoção de caminho crítico no modo auto que nenhuma regra ask cobre.
• Aviso de cobrança do classificador: onde o aviso sobre requisições cobradas do classificador abriria um diálogo, Claude Code não o mostra e nega as ações que precisam dessas requisições

Mensagens de denyInsteadOfPrompting

Permission for this tool use was denied. It requires approval, and this session has no approval surface

no approval surface in this session; permission request denied automatically

20 actions were refused and no work went ahead in between, so Claude stopped.

permissions.disableBypassPermissionsMode

• Escopo: Any file. Normalmente definido em configurações gerenciadas para aplicar a política organizacional.
• Tipo: a string "disable"
• Padrão: não definido
• Substituições por sessão: esta chave tem precedência sobre --dangerously-skip-permissions, que Claude Code rejeita enquanto a chave está definida

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

skipAutoPermissionPrompt

• Escopo: User or managed. Um repositório não pode defini-lo para você.
• Tipo: Booleano
  • true: Claude Code pula o aviso
  • false: o mesmo que não definido; o aviso aparece uma vez a menos que outro desses arquivos defina true
• Padrão: não definido, portanto o aviso aparece uma vez

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

• Escopo: User, local, or managed, e arquivos passados com --settings. Sessões em segundo plano consideram apenas configurações de usuário e gerenciadas. Um repositório não confiável não pode pular o diálogo para você.
• Tipo: Booleano
  • true: Claude Code pula o diálogo de confirmação antes de uma sessão entrar no modo bypassPermissions
  • false: o mesmo que não definido; o diálogo aparece a menos que outro desses arquivos defina true
• Padrão: não definido, portanto o diálogo aparece

{
  "skipDangerousModePermissionPrompt": true
}

Configurações de sandbox

sandbox

• Scope: Any file
• Tipo: objeto com enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations e ripgrep, além dos objetos filesystem, network e credentials
• Default: não definido, então Claude Code executa comandos sem sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

sandbox.enabled

• Scope: Any file, com limites em configurações de projeto e locais
• Type: Boolean
  • true: Claude Code faz sandbox dos comandos Bash
  • false: Comandos Bash são executados sem sandbox
• Default: false

{
  "sandbox": {
    "enabled": true
  }
}

sandbox.failIfUnavailable

• Scope: Any file, com limites em configurações de projeto e locais
• Tipo: booleano
  • true: o Claude Code encerra com um erro na inicialização quando sandbox.enabled é true, mas o sandbox não consegue iniciar. Se o sandbox passar nessa verificação e depois falhar ao inicializar, a sessão continua em execução e o Claude Code recusa cada comando no sandbox
  • false: o Claude Code executa os comandos fora do sandbox quando o sandbox não consegue iniciar
• Default: false

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

sandbox.autoAllowBashIfSandboxed

• Scope: Any file
• Type: Boolean
  • true: Claude Code executa comandos Bash em sandbox sem um prompt de permissão, exceto nos casos que Auto-allow mode descreve; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB desativa a auto-autorização
  • false: comandos em sandbox passam pelo fluxo de permissão regular, então suas regras de autorização e modo de permissão decidem. A aba Mode do /sandbox chama isso modo de permissões regular
• Default: true

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

sandbox.excludedCommands

• Scope: Any file, com limites em configurações de projeto e locais
• Type: array de padrões de comando
• Default: não definido, então nenhum comando é excluído

{
  "sandbox": {
    "excludedCommands": ["docker *"]
  }
}

• Um comando começando com sudo, eval ou xargs
• Um cd, pushd ou popd, onde quer que apareça na chamada
• Uma substituição de comando, um subshell ou um bloco de fluxo de controle como if ou for
• Um redirecionamento, como docker build . > build.log ou um heredoc <<EOF, exceto um que apenas duplica um descritor de arquivo, como 2>&1 faz
• Um nome de comando que vem de uma variável
• Um git clone, git init, git worktree add, git worktree move ou git bundle create com um argumento de caminho que é absoluto, começa com ~ ou contém um segmento ..

sandbox.allowUnsandboxedCommands

• Scope: Any file, com um limite em configurações de projeto e locais
• Type: Boolean
  • true: Claude pode tentar novamente um comando fora do sandbox com o parâmetro dangerouslyDisableSandbox depois que o sandbox o bloqueia
  • false: Claude Code ignora esse parâmetro, então, enquanto o sandbox está em execução, os comandos que Claude executa ficam em sandbox, a menos que correspondam a uma entrada de excludedCommands
• Default: true

{
  "sandbox": {
    "enabled"<