407| Usuario | `~/.claude/settings.json` | Usted, en cada proyecto en esta máquina | Preferencias personales: tema, modo de editor, modelo predeterminado, sus propias reglas de permiso |407| Usuario | `~/.claude/settings.json` | Usted, en cada proyecto en esta máquina | Preferencias personales: tema, modo de editor, modelo predeterminado, sus propias reglas de permiso |
408| Proyecto compartido | `.claude/settings.json` | Todos los que trabajan en la carpeta que lo contiene. En un repositorio de git, confirme para que los compañeros de equipo lo obtengan | Permisos de equipo, hooks, plugins y las variables de entorno que el proyecto necesita |408| Proyecto compartido | `.claude/settings.json` | Todos los que trabajan en la carpeta que lo contiene. En un repositorio de git, confirme para que los compañeros de equipo lo obtengan | Permisos de equipo, hooks, plugins y las variables de entorno que el proyecto necesita |
409| Proyecto local | `.claude/settings.local.json` | Usted, solo en este proyecto. Claude Code lo mantiene fuera de git cuando crea el archivo; si lo crea a mano, agréguelo a `.gitignore` usted mismo | Anulaciones personales para un proyecto y pruebas antes de compartir |409| Proyecto local | `.claude/settings.local.json` | Usted, solo en este proyecto. Claude Code lo mantiene fuera de git cuando crea el archivo; si lo crea a mano, agréguelo a `.gitignore` usted mismo | Anulaciones personales para un proyecto y pruebas antes de compartir |
410| Administrado | `managed-settings.json` y otros [mecanismos de entrega](/docs/es/managed-settings#delivery-mechanisms) | Todos en su organización a los que lo implementa; nada de lo que establezca lo anula, aparte de algunas [excepciones sensibles a la seguridad](#exceptions-to-managed-settings-precedence) | Política de seguridad y requisitos de cumplimiento |410| Administrado | `managed-settings.json` y otras [fuentes administradas](/docs/es/managed-settings#delivery-mechanisms) | Todos aquellos a quienes tu organización lo implementa; [Precedencia de la configuración](#settings-precedence) indica qué puede sobrescribirlo | Políticas de seguridad y requisitos de cumplimiento |
411 411
412En la columna Archivo, `~/.claude` es la carpeta `.claude` en su directorio de inicio, y un `.claude` simple es la carpeta `.claude` dentro de su proyecto.412En la columna Archivo, `~/.claude` es la carpeta `.claude` en su directorio de inicio, y un `.claude` simple es la carpeta `.claude` dentro de su proyecto.
413 413
653 Precedencia de configuración653 Precedencia de configuración
654</h2>654</h2>
655 655
656Cuando la misma clave aparece en más de un lugar, Claude Code usa el valor del nivel más alto que la establece. La pila a continuación muestra los niveles, más alto en la parte superior; una clave en un nivel más alto anula la misma clave en cualquier lugar debajo.656Cuando la misma clave aparece en más de un lugar, Claude Code usa el valor del nivel más alto que la establece. La pila a continuación muestra los niveles, con el más alto en la parte superior; una clave en un nivel más alto sobrescribe la misma clave en cualquier lugar debajo de él.
657 657
658<SettingsPrecedence />658<SettingsPrecedence />
659 659
660En orden, precedencia más alta primero:660En orden, precedencia más alta primero:
661 661
6621. **Configuraciones administradas**: configuraciones que su organización implementa, por un archivo `managed-settings.json`, una política MDM, o [configuraciones administradas por servidor](/docs/es/server-managed-settings) de la consola de claude.ai. Nada de lo que establezca las anula: una clave que pasa con `--settings` no anula la misma clave administrada, y una bandera como `--model` elige solo de los modelos que su organización permite. Una `model` administrada establece el modelo con el que cada sesión comienza, y aún puede cambiar con `/model`; el bloqueo es [`availableModels`](/docs/es/settings-reference#availablemodels), que restringe `/model`, `--model` y la clave `model` en sus propios archivos. Cuando su organización entrega más de una fuente administrada, las reglas para [precedencia dentro del nivel administrado](/docs/es/managed-settings#precedence-within-the-managed-tier) dicen qué lee Claude Code de cada una.6621. **Configuración administrada**: configuración que tu organización implementa mediante un archivo `managed-settings.json`, una política MDM o [configuración administrada por el servidor](/docs/es/server-managed-settings) desde la consola de claude.ai. Nada en tus propios archivos de configuración ni en `--settings` sobrescribe una clave administrada, y un flag como `--model` solo elige entre los modelos que tu organización permite. Un [`model`](/docs/es/settings-reference#model) administrado es un valor predeterminado inicial, no un bloqueo; los bloqueos son [`availableModels`](/docs/es/settings-reference#availablemodels) y [`deniedModels`](/docs/es/settings-reference#deniedmodels). Cuando tu organización entrega más de una fuente administrada, las reglas de [precedencia dentro del nivel administrado](/docs/es/managed-settings#precedence-within-the-managed-tier) indican qué lee Claude Code de cada una.
6632. **Argumentos de línea de comandos**: banderas que pasa cuando inicia `claude` desde una terminal, para una sesión; vea [Cambie una configuración para una sesión](#change-a-setting-for-one-session). Claude Code fusiona JSON que pasa con `--settings <file-or-json>` con sus archivos de configuración por las mismas reglas que los otros niveles: toma una clave que establece aquí sobre la misma clave en configuraciones locales, de proyecto o de usuario, y mantiene el valor de nivel inferior para una clave que omite.6632. **Línea de comandos**: JSON que pasas con `--settings <file-or-json>` al iniciar `claude`, solo para esa sesión; consulta [Cambiar un ajuste para una sesión](#change-a-setting-for-one-session). Una clave que estableces ahí sobrescribe la misma clave en tus archivos de configuración de proyecto y de usuario, y una clave que omites conserva su valor de esos archivos. Otros flags, como `--model`, establecen una sola cosa para la sesión y no forman parte de esta pila; la entrada de cada clave en la [referencia de configuración](/docs/es/settings-reference) indica qué flags la sobrescriben.
6643. **Configuraciones locales de proyecto** (`.claude/settings.local.json`): sus configuraciones personales para este proyecto.6643. **Configuración local del proyecto** (`.claude/settings.local.json`): tu configuración personal para este proyecto.
6654. **Configuraciones compartidas de proyecto** (`.claude/settings.json`): configuraciones que su equipo verifica en el control de código fuente.6654. **Configuración compartida del proyecto** (`.claude/settings.json`): configuración que tu equipo registra en el control de código fuente.
6665. **Configuraciones de usuario** (`~/.claude/settings.json`): sus configuraciones personales para cada proyecto.6665. **Configuración de usuario** (`~/.claude/settings.json`): tu configuración personal para todos los proyectos.
667 667
668Las variables de entorno no son un nivel en esta pila. Cuando un comportamiento tiene tanto una variable de shell como una clave de configuración, cuál se aplica se decide por par, no por nivel: `ANTHROPIC_MODEL` exportada en su shell se aplica sobre la clave `model` de cualquier archivo, mientras que `ANTHROPIC_DEFAULT_MODEL` se aplica solo cuando ningún archivo establece `model`. La [referencia de variables de entorno](/docs/es/env-vars#precedence) dice qué claves tienen un par y cuál lee Claude Code primero. Un bloque `env` dentro de un archivo de configuración es una clave ordinaria y sigue los niveles anteriores.668Las variables de entorno no son un nivel en esta pila. Cuando un comportamiento tiene tanto una variable de shell como una clave de configuración, cuál se aplica se decide por par, no por nivel: `ANTHROPIC_MODEL` exportada en tu shell se aplica sobre la clave `model` de cualquier archivo, mientras que `ANTHROPIC_DEFAULT_MODEL` se aplica solo cuando ningún archivo establece `model`. La [referencia de variables de entorno](/docs/es/env-vars#precedence) indica qué claves tienen un par y cuál lee Claude Code primero. Un bloque `env` dentro de un archivo de configuración es una clave ordinaria y sigue los niveles anteriores.
669 669
670Para algunas claves sensibles a la seguridad, Claude Code honra un valor más estricto de un nivel inferior sobre un valor administrado; [Excepciones a la precedencia de configuraciones administradas](#exceptions-to-managed-settings-precedence) las enumera.670Para algunas claves sensibles a la seguridad, Claude Code honra un valor más estricto de un nivel inferior sobre un valor administrado; [Excepciones a la precedencia de la configuración administrada](#exceptions-to-managed-settings-precedence) las enumera.
671 671
672<h3 id="lists-merge-instead-of-overriding">672<h3 id="lists-merge-instead-of-overriding">
673 Las listas se fusionan en lugar de anular673 Las listas se fusionan en lugar de sobrescribirse
674</h3>674</h3>
675 675
676Cuando establece la misma clave de lista, como `permissions.allow`, en más de un archivo, Claude Code combina las listas en lugar de elegir una, por lo que cada archivo puede agregar entradas sin eliminar las de otro archivo. Cuatro claves que contienen listas de modelos o entradas por modelo siguen sus propias reglas:676Cuando estableces la misma clave de lista, como `permissions.allow`, en más de un archivo, Claude Code combina las listas en lugar de elegir una, por lo que cada archivo puede agregar entradas sin eliminar las de otro archivo. Cuatro claves que contienen listas de modelos o entradas por modelo siguen sus propias reglas:
677 677
678* [`fallbackModel`](/docs/es/settings-reference#fallbackmodel) es una cadena ordenada donde la posición tiene significado, por lo que Claude Code toma el valor completo del archivo de mayor precedencia que la define.678* [`fallbackModel`](/docs/es/settings-reference#fallbackmodel) es una cadena ordenada donde la posición tiene significado, por lo que Claude Code toma el valor completo del archivo de mayor precedencia que la define.
679* [`modelPicker`](/docs/es/settings-reference#modelpicker) contiene una lista ordenada de filas más una bandera de reemplazo, por lo que Claude Code nunca fusiona filas de dos fuentes. Toma el valor completo del más alto de configuraciones administradas, `--settings` y configuraciones de usuario que la define, e ignora la clave en configuraciones de proyecto y local. Requiere Claude Code v2.1.242 o posterior.679* [`modelPicker`](/docs/es/settings-reference#modelpicker) contiene una lista ordenada de filas más una bandera de reemplazo, por lo que Claude Code nunca fusiona filas de dos fuentes. Toma el valor completo del nivel más alto, entre la configuración administrada, `--settings` y la configuración de usuario, que la define, e ignora la clave en la configuración de proyecto y local. Requiere Claude Code v2.1.242 o posterior.
680* [`availableModels`](/docs/es/settings-reference#availablemodels): cuando las configuraciones administradas que Claude Code aplica la definen, Claude Code aplica esa lista tal cual e ignora entradas que agrega en configuraciones de usuario, proyecto o local, a menos que una aplicación que incrusta Claude Code suministre su propia lista de modelos; vea [Excepciones a la precedencia de configuraciones administradas](#exceptions-to-managed-settings-precedence). Entre fuentes administradas la lista nunca se fusiona tampoco; [cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) dice qué lista de fuente se aplica. Entre ámbitos no administrados Claude Code fusiona las matrices como de costumbre.680* [`availableModels`](/docs/es/settings-reference#availablemodels): cuando la configuración administrada que Claude Code aplica la define, Claude Code aplica esa lista tal cual e ignora las entradas que agregas en la configuración de usuario, de proyecto o local, a menos que una aplicación que incrusta Claude Code suministre su propia lista de modelos; consulta [Excepciones a la precedencia de la configuración administrada](#exceptions-to-managed-settings-precedence). Entre fuentes administradas la lista tampoco se fusiona nunca; [cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) indica la lista de qué fuente se aplica. Entre alcances no administrados, Claude Code fusiona las matrices como de costumbre.
681* [`modelSettings`](/docs/es/settings-reference#modelsettings): Claude Code la resuelve un modelo a la vez, junto con [`effortLevel`](/docs/es/settings-reference#effortlevel). La entrada `modelSettings` indica qué archivo de valor se aplica a un modelo.681* [`modelSettings`](/docs/es/settings-reference#modelsettings): Claude Code la resuelve un modelo a la vez, junto con [`effortLevel`](/docs/es/settings-reference#effortlevel). La entrada `modelSettings` indica el valor de qué archivo se aplica a un modelo.
682 682
683<span id="examples" />683<span id="examples" />
684 684
686 Ejemplos de precedencia686 Ejemplos de precedencia
687</h3>687</h3>
688 688
689Mientras Claude trabaja, Claude Code muestra un consejo de una línea bajo el spinner, como "Use /config para cambiar su modo de permiso predeterminado (incluyendo Plan Mode)". Suponga que desea esos consejos apagados, por lo que establece [`spinnerTipsEnabled`](/docs/es/settings-reference#spinnertipsenabled) en `false` en `~/.claude/settings.json`. Cada escenario a continuación es algo que puede encenderlos de nuevo, y qué puede hacer al respecto.689Mientras Claude trabaja, Claude Code muestra un consejo de una línea bajo el spinner, como "Use /config to change your default permission mode (including Plan Mode)". Supón que quieres desactivar esos consejos, así que estableces [`spinnerTipsEnabled`](/docs/es/settings-reference#spinnertipsenabled) en `false` en `~/.claude/settings.json`. Cada escenario a continuación es algo que puede volver a activarlos, junto con lo que puedes hacer al respecto.
690 690
691<h4 id="team-settings-override-personal-settings">691<h4 id="team-settings-override-personal-settings">
692 Las configuraciones de equipo anulan las configuraciones personales692 La configuración del equipo sobrescribe la configuración personal
693</h4>693</h4>
694 694
695El `.claude/settings.json` de su equipo lo establece en `true`. Claude Code usa el valor del proyecto porque el proyecto compartido se sienta sobre el usuario, por lo que ve consejos en ese proyecto y en ningún otro lugar.695El `.claude/settings.json` de tu equipo lo establece en `true`. Claude Code usa el valor del proyecto porque el proyecto compartido está por encima del usuario, así que ves consejos en ese proyecto y en ningún otro lugar.
696 696
697Puede recuperar su valor: agregue `"spinnerTipsEnabled": false` a `.claude/settings.local.json` en ese proyecto. El proyecto local se sienta sobre el proyecto compartido, por lo que sus sesiones allí dejan de mostrar consejos y las sesiones de sus compañeros de equipo no cambian.697Puedes recuperar tu valor: agrega `"spinnerTipsEnabled": false` a `.claude/settings.local.json` en ese proyecto. El proyecto local está por encima del proyecto compartido, así que tus sesiones allí dejan de mostrar consejos y las sesiones de tus compañeros de equipo no cambian.
698 698
699<h4 id="organization-settings-override-everything">699<h4 id="organization-settings-override-everything">
700 Las configuraciones de la organización anulan todo700 La configuración de la organización sobrescribe todo
701</h4>701</h4>
702 702
703Las configuraciones administradas de su organización lo establecen en `true`. Nada de lo que ponga en configuraciones de usuario, proyecto o local apaga los consejos, y tampoco `--settings`. Administrado es el nivel superior.703La configuración administrada de tu organización lo establece en `true`. Nada de lo que pongas en la configuración de usuario, de proyecto o local desactiva los consejos, y `--settings` tampoco. La configuración administrada es el nivel superior.
704 704
705No puede recuperar su valor. Ejecute `/status` para ver qué fuente administrada se aplica, y pregunte a su administrador si la política debería cambiar.705No puedes recuperar tu valor. Ejecuta `/status` para ver qué fuente administrada se aplica, y pregunta a tu administrador si la política debería cambiar.
706 706
707<h4 id="the-command-line-overrides-your-files-for-one-session">707<h4 id="the-command-line-overrides-your-files-for-one-session">
708 La línea de comandos anula sus archivos para una sesión708 La línea de comandos sobrescribe tus archivos para una sesión
709</h4>709</h4>
710 710
711Inició la sesión con `claude --settings '{"spinnerTipsEnabled": true}'`. La línea de comandos se sienta sobre cada archivo excepto administrado, por lo que esa sesión muestra consejos aunque sus archivos digan `false`.711Iniciaste la sesión con `claude --settings '{"spinnerTipsEnabled": true}'`. La línea de comandos está por encima de todos los archivos excepto la configuración administrada, así que esa sesión muestra consejos aunque tus archivos digan `false`.
712 712
713Recupera su valor en la siguiente sesión; `--settings` dura una sesión y no escribe en ningún archivo.713Recuperas tu valor en la siguiente sesión; `--settings` dura una sesión y no escribe en ningún archivo.
714 714
715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">
716 Una bandera o variable de entorno establece lo mismo716 Un flag o una variable de entorno establece lo mismo
717</h4>717</h4>
718 718
719Algunas claves tienen una bandera de línea de comandos o una variable de entorno que anula el valor de configuración independientemente de qué archivo lo estableció: `ANTHROPIC_MODEL` anula la configuración [`model`](/docs/es/settings-reference#model), y `--model` anula ambas para una sesión.719Algunas claves tienen un flag de línea de comandos o una variable de entorno que sobrescribe el valor de configuración sin importar qué archivo lo estableció: `ANTHROPIC_MODEL` sobrescribe el ajuste [`model`](/docs/es/settings-reference#model), y `--model` sobrescribe ambos para una sesión.
720 720
721Si puede recuperar su valor depende de la clave: desexporte la variable o suelte la bandera, y verifique la entrada de la clave en la [referencia de configuración](/docs/es/settings-reference) y la fila de la variable en la [referencia de variables de entorno](/docs/es/env-vars) para cuál usa Claude Code.721Si puedes recuperar tu valor depende de la clave: quita la variable o deja de usar el flag, y consulta la entrada de la clave en la [referencia de configuración](/docs/es/settings-reference) y la fila de la variable en la [referencia de variables de entorno](/docs/es/env-vars) para saber cuál usa Claude Code.
722 722
723<span id="keys-ignored-in-a-repository-file" />723<span id="keys-ignored-in-a-repository-file" />
724 724
729<span id="which-value-applies-in-common-situations" />729<span id="which-value-applies-in-common-situations" />
730 730
731<h3 id="troubleshoot-a-setting-that-doesn’t-apply">731<h3 id="troubleshoot-a-setting-that-doesn’t-apply">
732 Solucione una configuración que no se aplica732 Solucionar un ajuste que no se aplica
733</h3>733</h3>
734 734
735Cuando establece una clave y Claude Code no se comporta como si lo hubiera hecho, comience con `/status` para ver qué archivos cargó, luego encuentre su síntoma a continuación. [Depure su configuración](/docs/es/debug-your-config) cubre las verificaciones más amplias, incluyendo una prueba de configuración limpia.735Cuando estableces una clave y Claude Code no se comporta como si lo hubieras hecho, empieza con `/status` para ver qué archivos cargó y luego busca tu síntoma a continuación. [Depura tu configuración](/docs/es/debug-your-config) cubre las verificaciones más amplias, incluida una prueba con una configuración limpia.
736 736
737<h4 id="a-value-you-set-is-ignored">737<h4 id="a-value-you-set-is-ignored">
738 Un valor que establece se ignora738 Un valor que estableces se ignora
739</h4>739</h4>
740 740
741Algo más está estableciendo la misma clave, el archivo no puede establecer ese valor, o el archivo no se cargó:741Algo más está estableciendo la misma clave, el archivo no puede establecer ese valor o el archivo no se cargó:
742 742
743* **Un nivel más alto lo establece.** Otro archivo de configuración, una bandera `--settings`, o una fuente administrada establece la clave por encima de la suya; la [pila](#settings-precedence) dice cuál. Una bandera o variable de entorno también puede anular la clave por su cuenta, decidido clave por clave; la entrada de la clave en la [referencia de configuración](/docs/es/settings-reference) dice cuál usa Claude Code, y la [entrada `env`](/docs/es/settings-reference#env) cubre un valor `env` administrado versus una exportación de shell.743* **Un nivel más alto lo establece.** Otro archivo de configuración, un flag `--settings` o una fuente administrada establece la clave por encima de la tuya; la [pila](#settings-precedence) indica cuál. Un flag o una variable de entorno también puede sobrescribir la clave por su cuenta, según cada clave; la entrada de la clave en la [referencia de configuración](/docs/es/settings-reference) indica cuál usa Claude Code, y la [entrada `env`](/docs/es/settings-reference#env) cubre un valor `env` administrado frente a una exportación del shell.
744* **Una clave de seguridad mantiene su valor estricto.** Para algunas claves Claude Code honra el valor restrictivo de cualquier archivo, por lo que un proyecto `true` para [`disableClaudeAiConnectors`](/docs/es/settings-reference#disableclaudeaiconnectors) permanece encendido; vea [Excepciones a la precedencia de configuraciones administradas](#exceptions-to-managed-settings-precedence).744* **Una clave de seguridad mantiene su valor estricto.** Para algunas claves, Claude Code honra el valor restrictivo de cualquier archivo, así que un `true` de proyecto para [`disableClaudeAiConnectors`](/docs/es/settings-reference#disableclaudeaiconnectors) permanece activado; consulta [Excepciones a la precedencia de la configuración administrada](#exceptions-to-managed-settings-precedence).
745* **El archivo no puede establecer ese valor.** Los valores [`permissions.defaultMode`](/docs/es/settings-reference#permissions-defaultmode) `auto` y `bypassPermissions` no surten efecto desde configuraciones de proyecto o local; establézcalos en configuraciones de usuario o administradas en su lugar, o pase `--permission-mode` para una sesión. Antes de v2.1.257, `bypassPermissions` surtía efecto desde cualquier archivo.745* **El archivo no puede establecer ese valor.** Los valores `auto` y `bypassPermissions` de [`permissions.defaultMode`](/docs/es/settings-reference#permissions-defaultmode) no surten efecto desde la configuración de proyecto o local; establécelos en la configuración de usuario o administrada, o pasa `--permission-mode` para una sesión. Antes de v2.1.257, `bypassPermissions` surtía efecto desde cualquier archivo.
746 746
747 Una variable de exportación de telemetría en un bloque [`env`](/docs/es/settings-reference#env) tampoco surte efecto desde configuraciones de proyecto o local, aparte de algunos valores desactivados. [Variables que Claude Code ignora en `env`](/docs/es/settings-reference#variables-claude-code-ignores-in-env) enumera las variables y esos valores.747 Una variable de exportación de telemetría en un bloque [`env`](/docs/es/settings-reference#env) tampoco surte efecto desde la configuración de proyecto o local, salvo algunos valores de desactivación. [Variables que Claude Code ignora en `env`](/docs/es/settings-reference#variables-claude-code-ignores-in-env) enumera las variables y esos valores.
748* **El archivo está roto.** JSON inválido o un valor rechazado hace que Claude Code omita el archivo o la entrada; vea [Corrija un archivo de configuración roto](#fix-a-broken-settings-file).748* **El archivo está dañado.** Un JSON no válido o un valor rechazado hace que Claude Code omita el archivo o la entrada; consulta [Corregir un archivo de configuración dañado](#fix-a-broken-settings-file).
749 749
750<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">750<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">
751 Un cambio que hizo en Claude Code se pierde en nuevas sesiones751 Un cambio que hiciste en Claude Code se pierde en nuevas sesiones
752</h4>752</h4>
753 753
754Cuando guarda una elección para nuevas sesiones desde dentro de Claude Code, como un modelo predeterminado con `/model`, Claude Code lo escribe en su archivo de configuración de usuario, `~/.claude/settings.json`. Si no puede escribir en ese archivo, por ejemplo porque otra herramienta lo genera o lo vincula a una copia de solo lectura, el cambio se aplica a la sesión actual y se pierde en la siguiente. Establezca la clave en la herramienta que genera el archivo, o reemplace el archivo con uno en el que pueda escribir.754Cuando guardas una elección para nuevas sesiones desde dentro de Claude Code, como un modelo predeterminado con `/model`, Claude Code la escribe en tu archivo de configuración de usuario, `~/.claude/settings.json`. Si no puedes escribir en ese archivo, por ejemplo porque otra herramienta lo genera o lo vincula a una copia de solo lectura, el cambio se aplica a la sesión actual y desaparece en la siguiente. Establece la clave en la herramienta que genera el archivo, o reemplaza el archivo por uno en el que puedas escribir.
755 755
756Si puede escribir en el archivo y el cambio aún no dura, verifique si el cambio fue [solo para una sesión](#change-a-setting-for-one-session) o [un nivel más alto establece la misma clave](#a-value-you-set-is-ignored). Para la clave `model`, [Una nueva sesión comienza en un modelo diferente al que eligió](/docs/es/model-config#a-new-session-starts-on-a-different-model-than-you-picked) enumera más causas.756Si puedes escribir en el archivo y el cambio aún no persiste, verifica si el cambio fue [solo para una sesión](#change-a-setting-for-one-session) o si [un nivel más alto establece la misma clave](#a-value-you-set-is-ignored). Para la clave `model`, [Una nueva sesión comienza con un modelo diferente al que elegiste](/docs/es/model-config#a-new-session-starts-on-a-different-model-than-you-picked) enumera más causas.
757 757
758<h4 id="a-managed-change-hasn’t-reached-you">758<h4 id="a-managed-change-hasn’t-reached-you">
759 Un cambio administrado no lo ha alcanzado759 Un cambio administrado no te ha llegado
760</h4>760</h4>
761 761
762Las fuentes administradas alcanzan una sesión en ejecución en el cronograma en la [tabla de entrega](/docs/es/managed-settings#choose-a-delivery-mechanism), por lo que reinicie la sesión primero. Si `/status` entonces nombra una fuente diferente a la que su administrador cambió, una fuente de mayor prioridad se aplica; [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) da el orden.762Las fuentes administradas llegan a una sesión en ejecución según el calendario de la [tabla de entrega](/docs/es/managed-settings#choose-a-delivery-mechanism), así que primero reinicia la sesión. Si luego `/status` nombra una fuente diferente a la que cambió tu administrador, se aplica una fuente de mayor prioridad; [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) indica el orden.
763 763
764<h4 id="a-committed-key-doesn’t-reach-teammates">764<h4 id="a-committed-key-doesn’t-reach-teammates">
765 Una clave confirmada no alcanza a los compañeros de equipo765 Una clave confirmada no llega a los compañeros de equipo
766</h4>766</h4>
767 767
768Dos cosas mantienen una clave en `.claude/settings.json` de aplicarse para todos los que la clonan:768Dos cosas impiden que una clave en `.claude/settings.json` se aplique para todos los que lo clonan:
769 769
770* **Claude Code ignora la clave en un archivo de repositorio.** Busque `User, local, or managed`, `User or managed`, `Managed`, o `Global config` en la columna Scope del [índice de configuración](/docs/es/settings-reference#settings-index). Esas claves nunca se aplican desde el archivo compartido, aparte de algunas que un archivo de repositorio aún puede apagar. Cada una de esas entradas lo dice en su línea de Scope. Las claves `Global config` se aplican solo desde `~/.claude.json`.770* **Claude Code ignora la clave en un archivo de repositorio.** Busca `User, local, or managed`, `User or managed`, `Managed` o `Global config` en la columna Scope del [índice de configuración](/docs/es/settings-reference#settings-index). Esas claves nunca se aplican desde el archivo compartido, salvo algunas que un archivo de repositorio aún puede desactivar. Cada una de esas entradas lo indica en su línea Scope. Las claves `Global config` se aplican solo desde `~/.claude.json`.
771 771
772 Dentro de la clave `env`, las variables de exportación de telemetría nunca se aplican desde el archivo compartido tampoco, aparte de algunos valores desactivados; vea [Variables que Claude Code ignora en `env`](/docs/es/settings-reference#variables-claude-code-ignores-in-env).772 Dentro de la clave `env`, las variables de exportación de telemetría tampoco se aplican nunca desde el archivo compartido, salvo algunos valores de desactivación; consulta [Variables que Claude Code ignora en `env`](/docs/es/settings-reference#variables-claude-code-ignores-in-env).
773* **La clave espera confianza.** Las reglas `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces` y la mayoría de valores [`env`](/docs/es/settings-reference#env) se aplican solo después de que cada compañero de equipo [confíe en la carpeta](/docs/es/permissions#project-allow-rules-and-workspace-trust). Hasta entonces aún ven avisos y no obtienen plugins de un marketplace que el archivo declara. Las reglas `deny` y `ask` se aplican de inmediato.773* **La clave espera la confianza.** Las reglas `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces` y la mayoría de los valores de [`env`](/docs/es/settings-reference#env) se aplican solo después de que cada compañero de equipo [confíe en la carpeta](/docs/es/permissions#project-allow-rules-and-workspace-trust). Hasta entonces, siguen viendo solicitudes de permiso y no obtienen plugins de un marketplace que el archivo declara. Las reglas `deny` y `ask` se aplican de inmediato.
774 774
775<h4 id="permission-rules-combine-differently-than-you-expected">775<h4 id="permission-rules-combine-differently-than-you-expected">
776 Las reglas de permiso se combinan diferente a lo que esperaba776 Las reglas de permisos se combinan de forma distinta a lo que esperabas
777</h4>777</h4>
778 778
779* **Eligió "Sí, y no preguntes de nuevo" en un aviso de permiso pero aún recibe avisos para la misma herramienta.** Esa elección guardó una regla `allow` en su archivo local, y una regla `allow` allí no supera una regla `ask` de un archivo de proyecto o administrado; [cómo se combinan las reglas de permiso](/docs/es/permissions#settings-precedence) explica el orden. En la extensión de VS Code la tarjeta de aprobación le permite elegir el archivo de destino, incluyendo el archivo compartido del proyecto, que cambia la regla para todos; en la CLI, Claude Code escribe solo en su archivo local.779* **Elegiste "Sí, y no preguntes de nuevo" en una solicitud de permiso, pero se te sigue pidiendo confirmación para la misma herramienta.** Esa elección guardó una regla `allow` en tu archivo local, y una regla `allow` allí no tiene prioridad sobre una regla `ask` de un archivo de proyecto o administrado; [cómo se combinan las reglas de permisos](/docs/es/permissions#settings-precedence) explica el orden. En la extensión de VS Code, la tarjeta de aprobación te permite elegir el archivo de destino, incluido el archivo compartido del proyecto, lo que cambia la regla para todos; en la CLI, Claude Code escribe solo en tu archivo local.
780* **Las reglas allow de su organización aún se aplican junto con las suyas.** Eso es esperado: Claude Code fusiona [`permissions.allow`](/docs/es/settings-reference#permissions-allow) entre ámbitos, a menos que su organización establezca [`allowManagedPermissionRulesOnly`](/docs/es/settings-reference#allowmanagedpermissionrulesonly).780* **Las reglas allow de tu organización aún se aplican junto con las tuyas.** Es lo esperado: Claude Code fusiona [`permissions.allow`](/docs/es/settings-reference#permissions-allow) entre alcances, a menos que tu organización establezca [`allowManagedPermissionRulesOnly`](/docs/es/settings-reference#allowmanagedpermissionrulesonly).
781 781
782<span id="security-keys-where-the-stricter-value-applies" />782<span id="security-keys-where-the-stricter-value-applies" />
783 783
784<h3 id="exceptions-to-managed-settings-precedence">784<h3 id="exceptions-to-managed-settings-precedence">
785 Excepciones a la precedencia de configuraciones administradas785 Excepciones a la precedencia de la configuración administrada
786</h3>786</h3>
787 787
788Para algunas claves cuyos valores restringen una sesión, Claude Code honra un valor restrictivo de un ámbito que de otra manera no podría anular configuraciones administradas. Encuentre la clave en esta tabla para ver qué valor honra y de dónde.788Para algunas claves cuyos valores restringen una sesión, Claude Code honra un valor restrictivo de un alcance que de otro modo no podría sobrescribir la configuración administrada. Busca la clave en esta tabla para ver qué valor honra y de dónde.
789 789
790| Clave | Valor que Claude Code honra | Notas |790| Clave | Valor que Claude Code honra | Notas |
791| :- | :- | :- |791| :- | :- | :- |
792| [`disableClaudeAiConnectors`](/docs/es/settings-reference#disableclaudeaiconnectors) | `true` de cualquier ámbito | Honrado incluso cuando una fuente administrada establece `false` |792| [`disableClaudeAiConnectors`](/docs/es/settings-reference#disableclaudeaiconnectors) | `true` de cualquier alcance | Honrado incluso cuando una fuente administrada establece `false` |
793| [`enableArtifact`](/docs/es/settings-reference#enableartifact) | `false` de cualquier ámbito, y `disableArtifact: true` de cualquier ámbito | Honrado incluso cuando una fuente administrada establece `true`; nada enciende la [herramienta Artifact](/docs/es/artifacts#disable-artifacts) de nuevo. Requiere Claude Code v2.1.242 o posterior |793| [`enableArtifact`](/docs/es/settings-reference#enableartifact) | `false` de cualquier alcance, y `disableArtifact: true` de cualquier alcance | Honrado incluso cuando una fuente administrada establece `true`; nada vuelve a activar la [herramienta Artifact](/docs/es/artifacts#disable-artifacts). Requiere Claude Code v2.1.242 o posterior |
794| [`isolatePeerMachines`](/docs/es/settings-reference#isolatepeermachines) | `true` de cualquier ámbito | Honrado incluso cuando una fuente administrada establece `false` |794| [`isolatePeerMachines`](/docs/es/settings-reference#isolatepeermachines) | `true` de cualquier alcance | Honrado incluso cuando una fuente administrada establece `false` |
795| [`remoteControlAtStartup`](/docs/es/settings-reference#remotecontrolatstartup) | `false` de `.claude/settings.json` o `.claude/settings.local.json` | Honrado incluso cuando una fuente administrada establece `true`; un proyecto o local `true` se ignora |795| [`permissions.blockReadsOutsideWorkingDirectories`](/docs/es/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` de cualquier alcance | Honrado incluso cuando una fuente administrada establece `false`. Requiere Claude Code v2.1.257 o posterior |
796| [`crossSessionInbound`](/docs/es/settings-reference#crosssessioninbound) | Un valor más estricto de `.claude/settings.json` o `.claude/settings.local.json`, en la escalera `accept` \< `hold` \< `refuse` | Honrado sobre valores administrados, `--settings` y de usuario; un valor de proyecto o local que no es más estricto se ignora |796| [`autoMode.classifyAllShell`](/docs/es/settings-reference#automode-classifyallshell) | `true` de `~/.claude/settings.json` o `--settings` | Honrado incluso cuando una fuente administrada establece `false` |
797| [`useAutoModeDuringPlan`](/docs/es/settings-reference#useautomodeduringplan) | `false` de cualquier fuente administrada, `--settings`, `~/.claude/settings.json`, o `.claude/settings.local.json` | Honrado incluso cuando la fuente administrada ganadora establece `true`; un `false` en `.claude/settings.json` se ignora |797| [`remoteControlAtStartup`](/docs/es/settings-reference#remotecontrolatstartup) | `false` de `.claude/settings.json` o `.claude/settings.local.json` | Honrado incluso cuando una fuente administrada establece `true`; un `true` de proyecto o local se ignora |
798| [`syncClaudeAiSkills`](/docs/es/settings-reference#syncclaudeaiskills) | `false` de cualquier fuente administrada, `--settings`, `~/.claude/settings.json`, o `.claude/settings.local.json` | Honrado incluso cuando la fuente administrada ganadora establece `true`; un `false` en `.claude/settings.json` se ignora |798| [`crossSessionInbound`](/docs/es/settings-reference#crosssessioninbound) | Un valor más estricto de `.claude/settings.json` o `.claude/settings.local.json`, en la escala `accept` \< `hold` \< `refuse` | Honrado sobre los valores administrados, de `--settings` y de usuario; un valor de proyecto o local que no sea más estricto se ignora |
799| [`syncClaudeAiPlugins`](/docs/es/settings-reference#syncclaudeaiplugins) | `false` de cualquier fuente administrada, `--settings`, `~/.claude/settings.json`, o `.claude/settings.local.json` | Honrado incluso cuando la fuente administrada ganadora establece `true`; un `false` en `.claude/settings.json` se ignora |799| [`useAutoModeDuringPlan`](/docs/es/settings-reference#useautomodeduringplan) | `false` de cualquier fuente administrada, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Honrado incluso cuando la fuente administrada ganadora establece `true`; un `false` en `.claude/settings.json` se ignora |
800| [`maxEffortLevel`](/docs/es/settings-reference#maxeffortlevel) | Un límite más bajo de cualquier ámbito, incluyendo `--settings` | Honrado incluso cuando las configuraciones administradas que Claude Code aplica establecen un límite más alto; se aplica el límite más bajo. Requiere Claude Code v2.1.267 o posterior |800| [`syncClaudeAiSkills`](/docs/es/settings-reference#syncclaudeaiskills) | `false` de cualquier fuente administrada, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Honrado incluso cuando la fuente administrada ganadora establece `true`; un `false` en `.claude/settings.json` se ignora |
801 801| [`syncClaudeAiPlugins`](/docs/es/settings-reference#syncclaudeaiplugins) | `false` de cualquier fuente administrada, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Honrado incluso cuando la fuente administrada ganadora establece `true`; un `false` en `.claude/settings.json` se ignora |
802Una aplicación que ejecuta Claude Code dentro de sí misma y establece [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/es/env-vars) también es una excepción. Claude Code toma la configuración de modelo de esa aplicación sobre las claves `model`, `fallbackModel`, `modelPicker`, y `modelOverrides` de cada fuente administrada, y sobre las variables de selección de modelo en un bloque `env` administrado, como `ANTHROPIC_MODEL` y la familia `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code mantiene una lista blanca [`availableModels`](/docs/es/settings-reference#availablemodels) administrada en vigor a menos que la aplicación suministre la suya.802| [`maxEffortLevel`](/docs/es/settings-reference#maxeffortlevel) | Un límite más bajo de cualquier alcance, incluido `--settings` | Honrado incluso cuando la configuración administrada que Claude Code aplica establece un límite más alto; se aplica el límite más bajo. Requiere Claude Code v2.1.267 o posterior |
803
804Una aplicación que ejecuta Claude Code dentro de sí misma y establece [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/es/env-vars) también es una excepción. Claude Code toma la configuración de modelo de esa aplicación por encima de las claves `model`, `fallbackModel`, `modelPicker` y `modelOverrides` de cada fuente administrada, y por encima de las variables de selección de modelo en un bloque `env` administrado, como `ANTHROPIC_MODEL` y la familia `ANTHROPIC_DEFAULT_*_MODEL`. Claude Code mantiene en vigor una lista de permitidos [`availableModels`](/docs/es/settings-reference#availablemodels) administrada, a menos que la aplicación suministre la suya.
803 805
804<h2 id="settings-in-cloud-sessions">806<h2 id="settings-in-cloud-sessions">
805 Configuraciones en sesiones en la nube807 Configuraciones en sesiones en la nube