Toda la configuración

Índice de configuración

Modelo y respuestas

advisorModel

• Alcance: Any file
• Tipo: string, uno de los alias "fable", "opus" o "sonnet", que se resuelven a la versión predeterminada actual de Claude Code de esa familia de modelos, o un ID de modelo completo como "claude-opus-5-5"
• Predeterminado: sin definir, por lo que el advisor está desactivado
• Sobrescrituras por sesión: --advisor tiene precedencia sobre esta clave durante una sesión. CLAUDE_CODE_DISABLE_ADVISOR_TOOL desactiva el advisor, y esta clave no puede volver a activarlo

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

• Alcance: Any file
• Tipo: Boolean
  • true: sin efecto; el pensamiento ya está activado
  • false: Claude Code desactiva el pensamiento extendido en todas las sesiones
• Predeterminado: sin definir, por lo que el pensamiento está activado en los modelos que lo admiten
• Sobrescrituras por sesión: MAX_THINKING_TOKENS tiene precedencia sobre esta clave durante una sesión: 0 desactiva el pensamiento, con los mismos límites de modelo y proveedor que false, y un valor positivo activa el pensamiento incluso cuando esta clave es false. En los modelos de razonamiento adaptativo, el número en sí se ignora

{
  "alwaysThinkingEnabled": false
}

availableModels

• Alcance: Any file. Despliégalo en la configuración administrada para aplicarlo en toda una organización.
• Tipo: array de alias o IDs de modelo
• Predeterminado: sin definir, por lo que todos los modelos están disponibles

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

availableModelsMatch

• Alcance: Managed. Claude Code ignora la clave en la configuración de usuario, de proyecto y local, y en --settings, con una advertencia
• Tipo: string, uno de:
  • "prefix": una entrada de ID de modelo permite su versión y cualquier ID de modelo que la extienda con otro segmento
  • "exact": una entrada de ID de modelo permite solo la versión que nombra, así que "claude-opus-5" permite Opus 5 pero no claude-opus-5-5. Una entrada como "claude-opus-4-5" también permite su ID de modelo de Anthropic con fecha claude-opus-4-5-20251101. Un alias de familia como "opus" sigue permitiendo toda la familia, y las entradas best, opusplan y default se ignoran
• Predeterminado: "prefix"

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

deniedModels

• Alcance: Managed. Claude Code ignora la clave en la configuración de usuario, de proyecto y local, y en --settings, con una advertencia
• Tipo: array de alias o IDs de modelo
  • Un alias de familia como "opus" bloquea todos los modelos de esa familia
  • Un ID de modelo como "claude-opus-5-5" bloquea esa versión en todas sus formas de escritura, incluidos los IDs con fecha y los específicos de proveedor
  • Un ID de modelo sin versión menor, como "claude-opus-5", también bloquea versiones menores posteriores como Opus 5.5. Escribe "claude-opus-5-0" para bloquear solo Opus 5
  • Las entradas best, opusplan y default se ignoran
• Predeterminado: sin definir, por lo que no se bloquea ningún modelo

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

effortLevel

• Alcance: Any file
• Tipo: string, uno de:
  • "low": el menor razonamiento, para tareas cortas, acotadas y sensibles a la latencia que no dependen de la inteligencia
  • "medium": reduce el uso de tokens en trabajo sensible al costo que puede sacrificar algo de inteligencia
  • "high": equilibra el uso de tokens y la inteligencia
  • "xhigh": razonamiento más profundo con mayor gasto de tokens
• Predeterminado: sin definir
• Sobrescrituras por sesión: --effort tiene precedencia sobre esta clave durante una sesión, y CLAUDE_CODE_EFFORT_LEVEL tiene precedencia sobre ambos

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

• Alcance: Any file
• Tipo: Boolean
  • true: cuando Default se resolvería a un modelo fuera de availableModels, Claude Code lo resuelve al primer modelo disponible de la lista
  • false: esta clave no cambia cómo se resuelve Default
• Predeterminado: false

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

fallbackModel

• Alcance: Any file
• Tipo: array de alias o IDs de modelo; "default" se expande al modelo predeterminado
• Predeterminado: sin definir, por lo que una solicitud fallida no se reintenta en otro modelo
• Sobrescrituras por sesión: --fallback-model tiene precedencia sobre esta clave durante una sesión

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

fastMode

• Alcance: Any file
• Tipo: Boolean
  • true: Claude Code activa el modo rápido en las sesiones donde esté disponible. En Fable 5.2, también debes ejecutar /fast mientras usas Fable 5.2
  • false: el modo rápido permanece desactivado
• Predeterminado: sin definir, por lo que el modo rápido está desactivado
• Sobrescrituras por sesión: CLAUDE_CODE_DISABLE_FAST_MODE desactiva el modo rápido durante una sesión, y esta clave no puede volver a activarlo

{
  "fastMode": true
}

fastModePerSessionOptIn

• Alcance: Any file
• Tipo: Boolean
  • true: un fastMode: true guardado ya no activa el modo rápido al iniciar la sesión, así que cada persona ejecuta /fast en cada sesión en la que lo quiera; un fastMode: true pasado con --settings sigue contando para esa sesión, a menos que la configuración administrada establezca esta clave
  • false: un fastMode: true guardado funciona como se describe en fastMode
• Predeterminado: false

{
  "fastModePerSessionOptIn": true
}

language

• Alcance: Any file
• Tipo: string, cualquier nombre de idioma, como "japanese", "spanish" o "french"; Claude Code no lo valida
• Predeterminado: sin definir; en ese caso, los títulos de sesión coinciden con el idioma de tu conversación

{
  "language": "japanese"
}

maxEffortLevel

• Alcance: Any file. Despliégalo en la configuración administrada para aplicarlo en toda una organización. Cuando varios alcances establecen un límite, se aplica el más bajo, así que un límite establecido en un alcance no se puede elevar desde otro
• Tipo: string, uno de "low", "medium", "high", "xhigh" o "max". Un valor "max" no establece ningún límite
• Predeterminado: sin definir, por lo que no se aplica ningún límite
• Límites por modelo: agrega maxEffortLevel a la entrada de un modelo en modelSettings. Esa entrada sustituye a esta clave para el modelo solo dentro de la fuente de configuración que establece ambas, como tu configuración de usuario o una fuente administrada. Establece "max" ahí para eximir al modelo del límite de esa fuente; Claude Code sigue aplicando los límites de otras fuentes

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

model

• Alcance: Any file
• Tipo: string, un alias de modelo o un ID de modelo completo
• Predeterminado: sin definir, por lo que Claude Code usa el modelo predeterminado de tu cuenta
• Sobrescrituras por sesión: --model tiene precedencia sobre ANTHROPIC_MODEL, y ambos tienen precedencia sobre esta clave durante una sesión, incluso sobre un model administrado; una lista de availableModels sigue aplicándose a la elección

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

modelOverrides

• Alcance: Any file
• Tipo: objeto que asigna un ID de modelo a un ID de modelo del proveedor
• Predeterminado: sin definir

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

modelPicker

• Alcance: User or managed. Claude Code lee la clave de la configuración administrada, de --settings y de la configuración de usuario, y la ignora en la configuración de proyecto y local para que un repositorio que clones no pueda cambiar las etiquetas del selector. La de mayor precedencia de esas tres que establezca la clave proporciona la lista completa, y Claude Code nunca combina listas de dos fuentes.
• Tipo: objeto con un array options de filas y un Boolean opcional replaceBuiltInOptions
• Predeterminado: sin definir, por lo que el selector muestra la 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

• Descartada: una fila que Claude Code no puede atender, como un modelo retirado o un modelo al que tu organización no tiene acceso
• Atenuada: una fila que aún no puedes seleccionar, que se muestra con el motivo
• No sobrevive ninguna fila: Claude Code mantiene la lista integrada, filtrada por la lista de permitidos como de costumbre

modelPricing

• Alcance: Managed. Despliega la clave mediante la configuración administrada por el servidor, una política de MDM, un archivo managed-settings.json o un programa auxiliar de políticas. Claude Code la ignora en la configuración de usuario, de proyecto y local, en --settings y, en Windows, en el registro HKCU en el que el usuario puede escribir. Con la configuración administrada por el servidor, cada sesión informa los costos a precio de lista hasta que la obtención de la configuración de esa sesión haya confirmado el ajuste. Una aplicación host que integra Claude Code y establece CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST puede proporcionar una tabla propia mediante la opción managedSettings del SDK, que Claude Code usa solo cuando ninguna fuente administrada establece la clave y solo en Claude Code v2.1.246 o posterior.
• Tipo: objeto con un multiplier opcional y un mapa overrides opcional
• Predeterminado: sin definir, por lo que Claude Code informa el precio de lista a menos que una aplicación host proporcione una tabla

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

Campos de modelPricing

A qué modelos se aplica una fila de modelPricing

• El ID de un modelo integrado: una clave que el propio Claude Code usa para un modelo integrado, ya sea el ID propio del modelo, como claude-sonnet-4-6, o su ID de Bedrock, Agent Platform o Foundry. Claude Code aplica la fila a todos los IDs de snapshot con fecha y a todos los IDs específicos de proveedor de ese modelo.
• Cualquier otra clave: una clave que no es el ID de un modelo integrado, como un alias de modelo de un gateway. Claude Code aplica la fila solo a ese ID. Cuando un ID de modelo coincide exactamente con una de tus claves y además queda comprendido en una fila cuya clave es el ID de un modelo integrado, Claude Code usa la coincidencia exacta.
• Un perfil de inferencia de aplicación de Bedrock: una vez que Claude Code ha resuelto el perfil al modelo al que enruta, mediante tu mapa de modelOverrides o la consulta bedrock:GetInferenceProfile, Claude Code aplica la fila de ese modelo al perfil.

modelSettings

• Alcance: Any file
• Tipo: objeto que asigna un nombre de modelo a un objeto con cualquiera de estos campos:
  • effortLevel: uno de "low", "medium", "high" o "xhigh"
  • maxEffortLevel: el nivel de esfuerzo más alto con el que puede ejecutarse el modelo
  • autoCompactWindow: un número de tokens de 100000 a 1000000, o "auto" para la ventana ajustada al modelo. /autocompact guarda aquí. Para ese modelo, el valor tiene precedencia sobre un autoCompactWindow de nivel superior en el mismo archivo de configuración. Requiere Claude Code v2.1.288 o posterior
• Predeterminado: sin definir

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

outputStyle

• Alcance: Any file
• Tipo: string, el nombre de un estilo de salida integrado o personalizado
• Predeterminado: sin definir, por lo que Claude Code usa el estilo predeterminado

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

• Alcance: Any file
• Tipo: string, uno de:
  • "5m": la caché se conserva durante cinco minutos
  • "1h": la caché se conserva durante una hora
• Predeterminado: sin definir, por lo que cada solicitud de la conversación principal obtiene su duración predeterminada
• Sobrescrituras por sesión: FORCE_PROMPT_CACHING_5M tiene precedencia sobre todo lo demás, luego CLAUDE_CODE_PROMPT_CACHE_TTL, luego esta clave y por último ENABLE_PROMPT_CACHING_1H

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

showThinkingSummaries

• Alcance: Any file
• Tipo: Boolean
  • true: ves los resúmenes completos del pensamiento al expandirlo con Ctrl+O
  • false: la API de Anthropic oculta los bloques de pensamiento y Claude Code muestra un marcador contraído
• Predeterminado: false

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

• Alcance: Any file
• Tipo: string, uno de:
  • "5m": la caché se conserva durante cinco minutos
  • "1h": la caché se conserva durante una hora
• Predeterminado: sin definir, por lo que cada una de estas solicitudes obtiene su duración predeterminada
• Sobrescrituras por sesión: FORCE_PROMPT_CACHING_5M tiene precedencia sobre todo lo demás, luego CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, luego esta clave y luego ENABLE_PROMPT_CACHING_1H, que solicita la duración de una hora en todas las solicitudes. Para saber dónde se sitúa el valor del frontmatter propio de un subagente, consulta Elegir el TTL tú mismo

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

• Alcance: Any file. Aparece en /config como Switch models when a message is flagged, con las opciones Switch automatically y Ask each time.
• Tipo: Boolean
  • true: Claude Code cambia al modelo de respaldo y continúa
  • false: en una sesión interactiva, Claude Code se pausa para que puedas elegir entre cambiar y editar el prompt; donde no se puede mostrar un cuadro de diálogo, como en una ejecución con -p, la solicitud marcada termina como un error
• Predeterminado: sin definir. Claude Code cambia automáticamente, aunque puede preguntar primero en una sesión interactiva

{
  "switchModelsOnFlag": false
}

ultracode

• Alcance: Any file
• Tipo: Boolean
  • true: las sesiones se inician con ultracode activado cuando los flujos de trabajo dinámicos están habilitados para ti y tu modelo admite xhigh
  • false: las sesiones se inician con ultracode desactivado
• Predeterminado: sin definir, por lo que ultracode está desactivado
• Sobrescrituras por sesión: /effort ultracode activa ultracode durante una sesión sin esta clave, y /effort ultracode off lo desactiva durante una sesión cuando esta clave es true. El flag --effort ultracode también lo activa durante una sesión, con esfuerzo xhigh

{
  "ultracode": true
}

Configuración de permisos

allowManagedPermissionRulesOnly

• El directorio .claude/ de un repositorio
• Tus directorios ~/.claude/skills/ y ~/.claude/commands/, incluidos los skills sincronizados desde claude.ai
• Un directorio --add-dir
• Plugins declarados con un manifiesto .claude-plugin dentro de ~/.claude/skills/ o del .claude/skills/ del proyecto
• Plugins cargados solo para una sesión, cuyos ids terminan en @inline, cuando se cumplen todas estas condiciones:
  • La sesión es una sesión de Code o una sesión de Cowork, distinta de una sesión en la nube, para la que la propia app Claude Desktop inicia Claude Code
  • Tu configuración administrada establece la clave, no solo la configuración principal de un host de incrustación
  • La sesión ejecuta Claude Code v2.1.305 o posterior

• Scope: Managed
• Type: Boolean
  • true: la configuración administrada se convierte en la única fuente de reglas de permisos
  • false: Claude Code aplica reglas de permisos de archivos de usuario, proyecto, local y --settings además de las administradas
• Default: sin establecer, por lo que Claude Code aplica reglas de permisos de configuración de usuario, proyecto y local y de --settings, además de las administradas

{
  "allowManagedPermissionRulesOnly": true
}

autoMode

• Scope: User or managed
• Type: objeto con matrices environment, allow, soft_deny y hard_deny de reglas en prosa, más el Boolean classifyAllShell
• Default: sin establecer, por lo que el clasificador usa solo sus reglas integradas

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

autoMode.classifyAllShell

• Scope: User or managed. Se lee donde se lee autoMode.
• Type: Boolean
  • true: mientras el modo automático está activo, Claude Code envía cada comando Bash y PowerShell a través del clasificador y suspende tus reglas de permitir de shell; fuera del modo automático las reglas aún se aplican
  • false: el modo automático suspende solo las reglas de permitir que podrían ejecutar código arbitrario, como Bash(*) y Bash(python *); un comando que coincida con cualquier otra regla de permitir omite el clasificador a menos que lleve dominios permitidos por comando, y todos los demás comandos de shell pasan por él
• Default: false

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

disableAutoMode

• Scope: Any file. Más útil en la configuración administrada, donde los usuarios no pueden sobrescribirlo. También se acepta bajo permissions como permissions.disableAutoMode.
• Type: la cadena "disable"
• Default: sin establecer

{
  "disableAutoMode": "disable"
}

permissions

• Scope: Any file
• Type: objeto con allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, blockWritesOutsideWorkingDirectories, defaultMode, denyInsteadOfPrompting, disableBypassPermissionsMode y disableAutoMode
• Default: sin establecer

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

useAutoModeDuringPlan

• Scope: User, local, or managed. Un repositorio no puede desactivarlo por ti.
  • Un false en cualquiera de estos archivos o en --settings lo desactiva, a menos que dejes fuera ese archivo de usuario o local con una opción como --setting-sources. Ignorar un archivo que se dejó fuera requiere Claude Code v2.1.314 o posterior
• Type: Boolean
  • true: lo mismo que sin establecer; cuando el modo automático está disponible, el clasificador revisa los comandos de shell durante la planificación
  • false: obtienes una solicitud de permiso para cada comando fuera del conjunto integrado de solo lectura
• Default: true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

• Scope: Any file
• Type: matriz de cadenas de reglas de permisos
• Default: sin establecer
• Per-session overrides: --allowedTools agrega reglas de permitir para una sesión, y una regla de denegar de cualquier archivo de configuración aún bloquea una herramienta que nombra

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

Sintaxis de reglas de permisos

permissions.ask

• Scope: Any file
• Type: matriz de cadenas de reglas de permisos
• Default: sin establecer

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

permissions.deny

• Scope: Any file
• Type: matriz de cadenas de reglas de permisos
• Default: sin establecer
• Per-session overrides: --disallowedTools agrega reglas de denegar para una sesión junto a esta clave

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

permissions.additionalDirectories

• Scope: Any file, con límites en el acceso de escritura del sandbox que otorgan las entradas de proyecto y locales
• Type: matriz de rutas de directorio
• Default: sin establecer
• Per-session overrides: --add-dir y /add-dir agregan directorios para una sesión junto a esta clave

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

permissions.blockReadsOutsideWorkingDirectories

• Acciones que ningún modo aprueba automáticamente explica cuándo un comando de shell que lee una ruta así te pide confirmación
• Comandos en el sandbox bajo el bloqueo explica lo que puede leer un comando en el sandbox

• Scope: Any file. Un true en cualquier archivo se aplica, por lo que un repositorio puede activar el bloqueo para sí mismo, pero no puede levantar el tuyo.
• Type: Boolean
  • true: las herramientas de archivo de Claude rechazan lecturas fuera de los directorios de trabajo
  • false: lo mismo que sin establecer; el bloqueo aún se aplica si otro archivo establece true
• Default: sin establecer, por lo que las lecturas fuera de los directorios de trabajo siguen tu modo de permisos

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

Comandos en el sandbox bajo el bloqueo

• El aislamiento del sistema de archivos está desactivado mediante sandbox.filesystem.disabled
• allowManagedReadPathsOnly está establecido
• La ruta del directorio en el que iniciaste Claude Code contiene un carácter glob como *, ? o [

• ~/.gitconfig
• Los archivos config, ignore y attributes bajo $XDG_CONFIG_HOME/git, que de forma predeterminada es ~/.config/git
• Los archivos que tu configuración global de git nombra mediante [include], [includeIf], core.excludesFile o core.attributesFile

permissions.blockWritesOutsideWorkingDirectories

• Scope: Any file. Un true en cualquier archivo que cargue la sesión se aplica, por lo que un repositorio puede activar el bloqueo para sí mismo, pero no puede levantar el tuyo. En una sesión en la nube, es posible que Claude Code no aplique la clave, porque las herramientas de archivo se ejecutan en un contenedor que es en sí mismo el límite.
• Type: Boolean
  • true: activa el bloqueo
  • false: lo mismo que sin establecer; el bloqueo aún se aplica si otro archivo establece true
• Default: sin establecer, por lo que las escrituras fuera de los directorios de trabajo siguen tu modo de permisos. El bloqueo también está activo mientras Claude Code no puede leer el objeto permissions de tu configuración administrada.

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

Qué rechaza el bloqueo de escritura y qué sigue siendo escribible

• Archivos de configuración de Claude Code: Claude Code rechaza estas escrituras también dentro de los directorios de trabajo, porque un archivo de configuración puede levantar el bloqueo. Edita tú mismo los archivos de configuración.
• Un directorio que solo agrega la configuración del repositorio: uno que additionalDirectories enumera solo en .claude/settings.json, o en .claude/settings.local.json a menos que git informe que ese archivo no está rastreado
• El worktree de un subagente: las ediciones de archivos de un subagente con isolation: worktree se rechazan cuando su worktree está fuera de los directorios de trabajo
• Memoria automática en un directorio que eligió el repositorio: un directorio que autoMemoryDirectory nombra en la configuración del repositorio

Dejar pasar un directorio a través del bloqueo de lectura o escritura

permissions.defaultMode

• Scope: Any file. auto y bypassPermissions no tienen efecto desde la configuración de proyecto o local, así que establécelos en ~/.claude/settings.json en su lugar. Antes de v2.1.257, bypassPermissions tenía efecto desde cualquier archivo. Para las conversaciones que inicia la extensión de VS Code, Claude Code lee solo los valores de usuario, administrados y de --settings.
• Type: cadena, una de:
  • "default": Claude Code ejecuta solo lecturas sin preguntar
  • "acceptEdits": Claude Code también ejecuta ediciones de archivos y comandos comunes del sistema de archivos como mkdir y mv sin preguntar
  • "plan": Claude Code lee y planifica, pero bloquea las ediciones hasta que apruebes un plan
  • "auto": Claude Code se ejecuta sin solicitudes habituales; antes de que se ejecuten acciones como comandos de shell y solicitudes de red, un clasificador en segundo plano verifica que se alineen con tu solicitud
  • "dontAsk": Claude Code deniega automáticamente cada llamada que de otro modo pediría confirmación, aunque un mod que instalaste aún puede aprobar algunas de esas llamadas. Las lecturas de archivos dentro de tus directorios de trabajo, otras acciones que no necesitan aprobación y las herramientas preaprobadas se siguen ejecutando, salvo las lecturas desde rutas de red
  • "bypassPermissions": Claude Code ejecuta todo sin preguntar
  • "manual": un alias de "default"
• Default: sin establecer
• Per-session overrides: --permission-mode, y su equivalente --dangerously-skip-permissions para bypassPermissions, tienen precedencia sobre esta clave para una sesión

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

permissions.denyInsteadOfPrompting

• Scope: User or managed, y --settings. Un repositorio no puede establecerlo por ti.
• Type: Boolean
  • true: Claude Code deniega las llamadas que de otro modo pedirían confirmación
  • false: lo mismo que sin establecer; las llamadas se siguen denegando si otra de estas fuentes establece true
• Default: sin establecer, por lo que una llamada que necesita aprobación te pide confirmación

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

Qué más detiene denyInsteadOfPrompting

• Herramientas de preguntas y de plan: Claude Code omite AskUserQuestion, EnterPlanMode y ExitPlanMode, por lo que una sesión en modo plan no puede salir de él por sí sola. Un compañero de equipo en un equipo de agentes conserva EnterPlanMode y ExitPlanMode
• Elicitación MCP: Claude Code cancela una solicitud de elicitación a menos que un hook Elicitation la responda
• Hosts de permisos: Claude Code no consulta tu callback canUseTool ni --permission-prompt-tool. Para aprobar llamadas desde código, responde desde un hook PermissionRequest. Algunas llamadas se deniegan antes de consultar cualquier hook, como una eliminación de ruta crítica en modo auto que ninguna regla ask cubre.
• Aviso de facturación del clasificador: donde el aviso sobre las solicitudes facturadas del clasificador abriría un diálogo, Claude Code no lo muestra y deniega las acciones que necesitan esas solicitudes

Mensajes 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

• Scope: Any file. Normalmente se establece en la configuración administrada para hacer cumplir la política de la organización.
• Type: la cadena "disable"
• Default: sin establecer
• Per-session overrides: esta clave tiene precedencia sobre --dangerously-skip-permissions, que Claude Code rechaza mientras la clave está establecida

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

skipAutoPermissionPrompt

• Scope: User or managed. Un repositorio no puede establecerlo por ti.
• Type: Boolean
  • true: Claude Code omite el aviso
  • false: lo mismo que sin establecer; el aviso aparece una vez a menos que otro de estos archivos establezca true
• Default: sin establecer, por lo que el aviso aparece una vez

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

• Scope: User, local, or managed, y los archivos pasados con --settings. Las sesiones en segundo plano solo tienen en cuenta la configuración de usuario y la administrada. Un repositorio que no es de confianza no puede omitir el diálogo por ti.
• Type: Boolean
  • true: Claude Code omite el diálogo de confirmación antes de que una sesión entre en el modo bypassPermissions
  • false: lo mismo que sin establecer; el diálogo aparece a menos que otro de estos archivos establezca true
• Default: sin establecer, por lo que el diálogo aparece

{
  "skipDangerousModePermissionPrompt": true
}

Configuración de sandbox

sandbox

• Scope: Any file
• Tipo: objeto con enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations y ripgrep, además de los objetos filesystem, network y credentials
• Default: sin establecer, por lo que Claude Code ejecuta comandos sin 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, con límites en la configuración de proyecto y local
• Type: Boolean
  • true: Claude Code ejecuta los comandos Bash en sandbox
  • false: los comandos Bash se ejecutan sin sandbox
• Default: false

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

sandbox.failIfUnavailable

• Scope: Any file, con límites en la configuración de proyecto y local
• Tipo: booleano
  • true: Claude Code termina con un error al iniciarse cuando sandbox.enabled es true pero el sandbox no puede iniciarse. Si el sandbox supera esa comprobación y luego no logra inicializarse, la sesión sigue en ejecución y Claude Code rechaza cada comando en el sandbox
  • false: Claude Code ejecuta los comandos sin sandbox cuando el sandbox no puede iniciarse
• Default: false

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

sandbox.autoAllowBashIfSandboxed

• Scope: Any file
• Type: Boolean
  • true: Claude Code ejecuta comandos Bash en sandbox sin una solicitud de permiso, excepto en los casos que describe Modo de aprobación automática; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB desactiva la aprobación automática
  • false: los comandos en sandbox pasan por el flujo de permisos normal, por lo que deciden tus reglas allow y tu modo de permisos. La pestaña Mode de /sandbox llama a esto modo de permisos normal
• Default: true

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

sandbox.excludedCommands

• Scope: Any file, con límites en la configuración de proyecto y local
• Type: array de patrones de comando
• Default: sin establecer, por lo que no se excluye ningún comando

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

• Un comando que comienza con sudo, eval o xargs
• Un cd, pushd o popd, dondequiera que aparezca en la llamada
• Una sustitución de comando, un subshell o un bloque de flujo de control como if o for
• Una redirección, como docker build . > build.log o un heredoc <<EOF, salvo una que solo duplique un descriptor de archivo, como hace 2>&1
• Un nombre de comando que proviene de una variable
• Un git clone, git init, git worktree add, git worktree move o git bundle create con un argumento de ruta que es absoluto, comienza con ~ o contiene un segmento ..

sandbox.allowUnsandboxedCommands

• Scope: Any file, con un límite en la configuración de proyecto y local
• Type: Boolean
  • true: Claude puede reintentar un comando fuera del sandbox con el parámetro dangerouslyDisableSandbox después de que el sandbox lo bloquee
  • false: Claude Code ignora ese parámetro, por lo que, mientras el sandbox está en ejecución, los comandos que Claude ejecuta quedan en sandbox a menos que coincidan con una entrada de excludedCommands
• Default: true

{
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false