402 402
403Claude Code lee la configuración de cuatro archivos, y una organización también puede entregar configuración administrada desde la consola de claude.ai. Cada fuente tiene un alcance: el conjunto de personas y proyectos a los que se aplica un ajuste guardado en ella, ya seas solo tú, todos en un proyecto o todos en tu organización.403Claude Code lee la configuración de cuatro archivos, y una organización también puede entregar configuración administrada desde la consola de claude.ai. Cada fuente tiene un alcance: el conjunto de personas y proyectos a los que se aplica un ajuste guardado en ella, ya seas solo tú, todos en un proyecto o todos en tu organización.
404 404
405| Ámbito | Archivo | A quién afecta | Úselo para |405| Alcance | Archivo | A quién afecta | Úsalo para |
406| :- | :- | :- | :- |406| :- | :- | :- | :- |
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` | Tú, en cada proyecto en esta máquina | Preferencias personales: tema, modo de editor, modelo predeterminado, tus propias reglas de permisos |
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, haz commit del archivo para que tus 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` | Tú, solo en este proyecto. Claude Code lo mantiene fuera de git cuando crea el archivo; si lo creas a mano, agrégalo a `.gitignore` tú mismo | Sobrescrituras personales para un proyecto y pruebas antes de compartir |
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 |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 tu directorio home, y un `.claude` simple es la carpeta `.claude` dentro de tu proyecto.
413 413
414<span id="where-each-file-applies" />414<span id="where-each-file-applies" />
415 415
416<span id="compare-what-each-file-reaches" />416<span id="compare-what-each-file-reaches" />
417 417
418<h3 id="compare-the-scope-of-each-settings-file">418<h3 id="compare-the-scope-of-each-settings-file">
419 Compare el ámbito de cada archivo de configuración419 Compara el alcance de cada archivo de configuración
420</h3>420</h3>
421 421
422Suponga que tiene tres proyectos en su máquina, `website/`, `api/` y `acme-app/`, un compañero de equipo tiene su propio clon de `acme-app/`, e inicia una [sesión en la nube](#settings-in-cloud-sessions) en `acme-app/`.422Supón que tienes tres proyectos en tu máquina, `website/`, `api/` y `acme-app/`, un compañero de equipo tiene su propio clon de `acme-app/`, e inicias una [sesión en la nube](#settings-in-cloud-sessions) en `acme-app/`.
423 423
424El gráfico a continuación muestra a cuál de esas carpetas se aplica una configuración cuando inicia Claude Code desde ellas. Haga clic en un archivo de configuración para ver las carpetas que alcanza.424El gráfico a continuación muestra en cuáles de esas carpetas se aplica un ajuste cuando inicias Claude Code desde ellas. Haz clic en un archivo de configuración para ver las carpetas que alcanza.
425 425
426<SettingsScope />426<SettingsScope />
427 427
428* **`~/.claude/settings.json`**: cada proyecto en su máquina, y nada en la de su compañero de equipo o en la sesión en la nube428* **`~/.claude/settings.json`**: cada proyecto en tu máquina, y nada en la de tu compañero de equipo ni en la sesión en la nube
429* **`acme-app/.claude/settings.json`**: su `acme-app/`. Alcanza el clon de su compañero de equipo y la sesión en la nube solo si confirma el archivo en el control de versiones; hasta entonces, es un archivo en su disco como cualquier otro y nadie más lo tiene429* **`acme-app/.claude/settings.json`**: tu `acme-app/`. Alcanza el clon de tu compañero de equipo y la sesión en la nube solo si haces commit del archivo en el control de versiones; hasta entonces, es un archivo en tu disco como cualquier otro y nadie más lo tiene
430* **`acme-app/.claude/settings.local.json`**: su `acme-app/` solo. Claude Code lo agrega a sus exclusiones globales de git la primera vez que escribe el archivo, por lo que se mantiene fuera de sus confirmaciones; si crea el archivo a mano, [agréguelo a `.gitignore` usted mismo](#keep-personal-settings-out-of-a-repository)430* **`acme-app/.claude/settings.local.json`**: solo tu `acme-app/`. Claude Code lo agrega a tus exclusiones globales de git la primera vez que escribe el archivo, por lo que se mantiene fuera de tus commits; si creas el archivo a mano, [agrégalo a `.gitignore` tú mismo](#keep-personal-settings-out-of-a-repository)
431* **Configuraciones administradas**, ya sea un archivo `managed-settings.json`, una política MDM, o [configuraciones administradas por servidor](/docs/es/server-managed-settings) desde la consola de claude.ai: cada proyecto en cada máquina en la que su organización lo implementa, o en la que inicia sesión con su cuenta de organización. Solo las configuraciones administradas por servidor alcanzan la sesión en la nube431* **Configuración administrada**, ya sea un archivo `managed-settings.json`, una política MDM o la [configuración administrada por servidor](/docs/es/server-managed-settings) desde la consola de claude.ai: cada proyecto en cada máquina en la que tu organización la implementa, o en la que inicias sesión con tu cuenta de organización. Solo la configuración administrada por servidor alcanza la sesión en la nube
432 432
433<span id="which-files-you-have" />433<span id="which-files-you-have" />
434 434
435<h3 id="find-or-create-your-settings-files">435<h3 id="find-or-create-your-settings-files">
436 Encuentre o cree sus archivos de configuración436 Encuentra o crea tus archivos de configuración
437</h3>437</h3>
438 438
439Instalar Claude Code no crea ningún archivo de configuración. Si su máquina o proyecto ya tiene uno, vino de una de estas fuentes:439Instalar Claude Code no crea ningún archivo de configuración. Si tu máquina o proyecto ya tiene uno, vino de una de estas fuentes:
440 440
441* **Administrado**: su organización lo implementa. Usted no lo crea ni lo edita.441* **Administrado**: tu organización lo implementa. Tú no lo creas ni lo editas.
442* **Proyecto compartido**: un proyecto que ya usa Claude Code puede tener uno confirmado. Si no, créelo en `.claude/settings.json` en la carpeta del proyecto.442* **Proyecto compartido**: un proyecto que ya usa Claude Code puede tener uno con commit. Si no, créalo en `.claude/settings.json` en la carpeta del proyecto.
443* **Usuario** y **Proyecto local**: créelos usted mismo, o deje que Claude Code los cree. Escribe `~/.claude/settings.json` la primera vez que cambia una opción en el menú `/config` que almacena en configuraciones de usuario, como el tema, y `.claude/settings.local.json` la primera vez que da una aprobación permanente en un aviso de permiso, como "Sí, y no preguntes de nuevo" para un comando Bash. Algunas opciones de `/config`, incluyendo **Mostrar consejos**, se guardan en `.claude/settings.local.json` en su lugar.443* **Usuario** y **Proyecto local**: créalos tú mismo, o deja que Claude Code los cree. Escribe `~/.claude/settings.json` la primera vez que cambias una opción en el menú `/config` que almacena en la configuración de usuario, como el tema, y `.claude/settings.local.json` la primera vez que das una aprobación permanente en una solicitud de permiso, como "Sí, y no preguntes de nuevo" para un comando Bash. Algunas opciones de `/config`, incluida **Mostrar consejos**, se guardan en `.claude/settings.local.json` en lugar del archivo de usuario.
444 444
445<Info>445<Info>
446 En Windows, `~/.claude` significa `%USERPROFILE%\.claude`. Para mantener los archivos del directorio de inicio en otro lugar, establezca [`CLAUDE_CONFIG_DIR`](/docs/es/env-vars); Claude Code almacena sus configuraciones, historial de sesiones y plugins allí en su lugar.446 En Windows, `~/.claude` significa `%USERPROFILE%\.claude`. Para mantener los archivos del directorio home en otro lugar, establece [`CLAUDE_CONFIG_DIR`](/docs/es/env-vars); Claude Code entonces almacena tu configuración, historial de sesiones y plugins allí.
447</Info>447</Info>
448 448
449Claude Code también mantiene un quinto archivo, [`~/.claude.json`](/docs/es/claude-directory#ce-claude-json), que escribe para sí mismo; no necesita editarlo. Contiene su sesión de inicio de sesión, configuraciones de [servidor MCP](/docs/es/mcp), estado por proyecto como decisiones de confianza, y las [claves de configuración global](/docs/es/settings-reference#global-config-settings) que `/config` escribe para usted.449Claude Code también mantiene un quinto archivo, [`~/.claude.json`](/docs/es/claude-directory#ce-claude-json), que escribe para sí mismo; no necesitas editarlo. Contiene tu sesión de inicio de sesión, configuraciones de [servidores MCP](/docs/es/mcp), estado por proyecto como decisiones de confianza, y las [claves de configuración global](/docs/es/settings-reference#global-config-settings) que `/config` escribe por ti.
450 450
451<h3 id="share-settings-with-your-team">451<h3 id="share-settings-with-your-team">
452 Comparta configuraciones con su equipo452 Comparte la configuración con tu equipo
453</h3>453</h3>
454 454
455Confirme `.claude/settings.json` para que todos los que clonan el repositorio obtengan los mismos permisos, hooks y plugins. Cada compañero de equipo aún puede anularlo para sí mismo en su propio `.claude/settings.local.json`, por lo que las excepciones personales no necesitan una confirmación. Para un archivo de equipo completo, vea [configuraciones compartidas de un equipo](/docs/es/settings-example#a-teams-shared-settings).455Haz commit de `.claude/settings.json` para que todos los que clonen el repositorio obtengan los mismos permisos, hooks y plugins. Cada compañero de equipo aún puede sobrescribirlo para sí mismo en su propio `.claude/settings.local.json`, por lo que las excepciones personales no necesitan un commit. Para un archivo de equipo completo, consulta [la configuración compartida de un equipo](/docs/es/settings-example#a-teams-shared-settings).
456 456
457Parte de lo que confirma espera hasta que cada compañero de equipo [confíe en la carpeta](/docs/es/permissions#project-allow-rules-and-workspace-trust), y algunas claves nunca surten efecto desde un archivo de repositorio; [Solucione una configuración que no se aplica](#common-cases) cubre ambas.457Parte de lo que incluyes en el commit espera hasta que cada compañero de equipo [confíe en la carpeta](/docs/es/permissions#project-allow-rules-and-workspace-trust), y algunas claves nunca surten efecto desde un archivo del repositorio; [Solucionar un ajuste que no se aplica](#common-cases) cubre ambos casos.
458 458
459<span id="local-settings-file" />459<span id="local-settings-file" />
460 460
465<span id="keep-personal-settings-out-of-the-repository" />465<span id="keep-personal-settings-out-of-the-repository" />
466 466
467<h3 id="keep-personal-settings-out-of-a-repository">467<h3 id="keep-personal-settings-out-of-a-repository">
468 Mantenga las configuraciones personales fuera de un repositorio468 Mantén la configuración personal fuera de un repositorio
469</h3>469</h3>
470 470
471Para cambiar una configuración para usted en un proyecto sin cambiarla para sus compañeros de equipo, guárdela en `.claude/settings.local.json` dentro del proyecto. Claude Code aplica ese archivo sobre el `.claude/settings.json` confirmado, por lo que si el archivo de su equipo establece `"model": "claude-sonnet-5"` y usted quiere Opus, ponga `"model": "claude-opus-5-5"` en su archivo local y solo sus sesiones cambian.471Para cambiar un ajuste solo para ti en un proyecto sin cambiarlo para tus compañeros de equipo, guárdalo en `.claude/settings.local.json` dentro del proyecto. Claude Code aplica ese archivo sobre el `.claude/settings.json` con commit, por lo que si el archivo de tu equipo establece `"model": "claude-sonnet-5"` y tú quieres Opus, pon `"model": "claude-opus-5-5"` en tu archivo local y solo tus sesiones cambian.
472 472
473Claude Code también escribe en este archivo, lo mantiene fuera de sus confirmaciones, y aplica sus reglas allow sin el paso de confianza:473Claude Code también escribe en este archivo, lo mantiene fuera de tus commits y aplica sus reglas allow sin el paso de confianza:
474 474
475* **Claude Code también lo escribe.** Cuando Claude pide permiso para ejecutar un comando Bash y elige "Sí, y no preguntes de nuevo", Claude Code guarda esa [aprobación de permiso](/docs/es/permissions#permission-system) aquí como una regla `allow`.475* **Claude Code también lo escribe.** Cuando Claude pide permiso para ejecutar un comando Bash y eliges "Sí, y no preguntes de nuevo", Claude Code guarda esa [aprobación de permiso](/docs/es/permissions#permission-system) aquí como una regla `allow`.
476* **No necesita gitignore usted mismo, a menos que lo haya creado a mano.** La primera vez que Claude Code escribe el archivo en un repositorio de git que aún no lo ignora, agrega `**/.claude/settings.local.json` a su archivo de exclusiones global de git, por lo que el archivo se mantiene fuera de sus confirmaciones en cada repositorio. Ese archivo es `core.excludesFile` cuando su configuración global de git lo establece en una ruta absoluta o con prefijo `~`; de lo contrario es `$XDG_CONFIG_HOME/git/ignore`, o `~/.config/git/ignore` cuando `XDG_CONFIG_HOME` no está establecido. Si creó el archivo a mano y Claude Code aún no ha escrito en él, agréguelo a `.gitignore` usted mismo.476* **No necesitas agregarlo a gitignore tú mismo, a menos que lo hayas creado a mano.** La primera vez que Claude Code escribe el archivo en un repositorio de git que aún no lo ignora, agrega `**/.claude/settings.local.json` a tu archivo global de exclusiones de git, por lo que el archivo se mantiene fuera de tus commits en cada repositorio. Ese archivo es `core.excludesFile` cuando tu configuración global de git lo establece en una ruta absoluta o con prefijo `~`; de lo contrario es `$XDG_CONFIG_HOME/git/ignore`, o `~/.config/git/ignore` cuando `XDG_CONFIG_HOME` no está establecido. Si creaste el archivo a mano y Claude Code aún no ha escrito en él, agrégalo a `.gitignore` tú mismo.
477* **Sus reglas allow no esperan confianza mientras el archivo permanece sin rastrear.** Porque el archivo es suyo y no del repositorio, Claude Code aplica sus reglas `allow` sin el paso de [confianza del espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust) que requiere para el archivo confirmado. Si el archivo es rastreado por git, el paso de confianza también se aplica a él; vea [Cuando su archivo de configuración local necesita confianza](/docs/es/permissions#when-your-local-settings-file-needs-trust).477* **Sus reglas allow no esperan confianza mientras el archivo permanezca sin rastrear.** Como el archivo es tuyo y no del repositorio, Claude Code aplica sus reglas `allow` sin el paso de [confianza del espacio de trabajo](/docs/es/permissions#project-allow-rules-and-workspace-trust) que requiere para el archivo con commit. Si git rastrea el archivo, el paso de confianza también se le aplica; consulta [Cuando tu archivo de configuración local necesita confianza](/docs/es/permissions#when-your-local-settings-file-needs-trust).
478 478
479<span id="where-claude-code-looks-for-each-file" />479<span id="where-claude-code-looks-for-each-file" />
480 480
483<span id="local-allow-rules-dont-wait-for-workspace-trust" />483<span id="local-allow-rules-dont-wait-for-workspace-trust" />
484 484
485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">
486 Dónde Claude Code mantiene el archivo local en un repositorio de git486 Dónde mantiene Claude Code el archivo local en un repositorio de git
487</h4>487</h4>
488 488
489Cuando Claude pide permiso para ejecutar un comando Bash y elige "Sí, y no preguntes de nuevo", Claude Code guarda esa aprobación como una regla `allow` en `.claude/settings.local.json`. Si inicia Claude Code en un subdirectorio de un repositorio de git, lee y escribe ese archivo en la raíz del repositorio y aplica la aprobación en todo el repositorio. En un [worktree](/docs/es/worktrees), usa el archivo en la raíz del checkout principal.489Cuando Claude pide permiso para ejecutar un comando Bash y eliges "Sí, y no preguntes de nuevo", Claude Code guarda esa aprobación como una regla `allow` en `.claude/settings.local.json`. Si inicias Claude Code en un subdirectorio de un repositorio de git, lee y escribe ese archivo en la raíz del repositorio y aplica la aprobación en todo el repositorio. En un [worktree](/docs/es/worktrees), usa el archivo en la raíz del checkout principal.
490 490
491Dos reglas califican la ubicación raíz:491Dos reglas matizan la ubicación en la raíz:
492 492
493* **Cuando el archivo se queda con `.claude/settings.json` en su lugar**: fuera de un repositorio de git, cuando la raíz del repositorio es su directorio de inicio, en Windows, o cuando la raíz del repositorio o su entrada `.git` o `.claude` no es propiedad de su usuario.493* **Cuando el archivo se queda junto a `.claude/settings.json`**: fuera de un repositorio de git, cuando la raíz del repositorio es tu directorio home, en Windows, o cuando la raíz del repositorio o su entrada `.git` o `.claude` no es propiedad de tu usuario.
494* **Las rutas en el archivo no se anclan en la raíz del repositorio**: una regla de permiso que comienza con `/` o una ruta de sandbox relativa [se ancla en el directorio de trabajo principal de la sesión](/docs/es/permissions#read-and-edit) en su lugar.494* **Las rutas en el archivo no se anclan en la raíz del repositorio**: una regla de permisos que comienza con `/` o una ruta relativa del sandbox [se ancla en el directorio de trabajo principal de la sesión](/docs/es/permissions#read-and-edit).
495 495
496Antes de v2.1.211, Claude Code mantenía el archivo en el directorio de inicio. Aún lee un archivo que una versión anterior dejó allí junto al archivo raíz; donde ambos establecen la misma clave, se aplica el valor de la raíz, y las reglas de permiso de ambos archivos se aplican. El asistente [`resolveSettings()`](/docs/es/agent-sdk/typescript#resolvesettings) del Agent SDK siempre lee el archivo desde el directorio de inicio.496Antes de v2.1.211, Claude Code mantenía el archivo en el directorio donde lo iniciaste. Aún lee un archivo que una versión anterior dejó allí junto al archivo de la raíz; donde ambos establecen la misma clave, se aplica el valor de la raíz, y se aplican las reglas de permisos de ambos archivos. El helper [`resolveSettings()`](/docs/es/agent-sdk/typescript#resolvesettings) del Agent SDK siempre lee el archivo desde el directorio donde se inició.
497 497
498Claude Code lee el `.claude/settings.json` compartido desde el [directorio de trabajo principal](/docs/es/permissions#working-directories) de la sesión, por lo que para usar un archivo confirmado en la raíz del repositorio, inicie Claude Code allí. Después de [mover la sesión con `/cd`](/docs/es/permissions#move-the-session-to-another-directory), Claude Code lee ambos archivos de proyecto desde el nuevo directorio en su lugar, colocando el archivo local por las mismas reglas. Leerlos desde el directorio al que se movió requiere Claude Code v2.1.246 o posterior.498Claude Code lee el `.claude/settings.json` compartido desde el [directorio de trabajo principal](/docs/es/permissions#working-directories) de la sesión, así que para usar un archivo con commit en la raíz del repositorio, inicia Claude Code allí. Después de [mover la sesión con `/cd`](/docs/es/permissions#move-the-session-to-another-directory), Claude Code lee ambos archivos de proyecto desde el nuevo directorio, ubicando el archivo local según las mismas reglas. Leerlos desde el directorio al que te moviste requiere Claude Code v2.1.246 o posterior.
499 499
500<span id="managed-settings-delivery" />500<span id="managed-settings-delivery" />
501 501
508<span id="settings-your-organization-manages" />508<span id="settings-your-organization-manages" />
509 509
510<h3 id="check-what-your-organization-enforces">510<h3 id="check-what-your-organization-enforces">
511 Verifique qué aplica su organización511 Verifica qué impone tu organización
512</h3>512</h3>
513 513
514Si su organización administra Claude Code, algunas configuraciones se deciden para usted y nada de lo que ponga en sus propios archivos las cambia. Para ver cuáles, ejecute `/status`: la línea `Setting sources` nombra la fuente administrada que se aplica a usted. Las configuraciones administradas se aplican dondequiera que Claude Code se ejecute en esta máquina; [Lo que un desarrollador puede cambiar](/docs/es/managed-settings#what-a-developer-can-change) cubre derechos de administrador local y herramientas distintas de Claude Code.514Si tu organización administra Claude Code, algunos ajustes se deciden por ti y nada de lo que pongas en tus propios archivos los cambia. Para ver cuáles, ejecuta `/status`: la línea `Setting sources` nombra la fuente administrada que se te aplica. La configuración administrada se aplica dondequiera que Claude Code se ejecute en esta máquina; [Lo que un desarrollador puede cambiar](/docs/es/managed-settings#what-a-developer-can-change) cubre los derechos de administrador local y las herramientas distintas de Claude Code.
515 515
516Las configuraciones administradas lo alcanzan a través de los [mecanismos de entrega](/docs/es/managed-settings#delivery-mechanisms) en la página de configuraciones administradas, más comúnmente:516La configuración administrada te llega a través de los [mecanismos de entrega](/docs/es/managed-settings#delivery-mechanisms) de la página de configuración administrada, más comúnmente:
517 517
518* [Configuraciones administradas por servidor](/docs/es/server-managed-settings), que Claude Code obtiene de la consola de administrador de claude.ai o de una [puerta de aplicaciones Claude](/docs/es/claude-apps-gateway) autohospedada518* [Configuración administrada por servidor](/docs/es/server-managed-settings), que Claude Code obtiene de la consola de administración de claude.ai o de un [gateway de aplicaciones de Claude](/docs/es/claude-apps-gateway) autohospedado
519* Políticas MDM o a nivel de SO, y archivos `managed-settings.json` en un directorio del sistema519* Políticas MDM o a nivel del sistema operativo, y archivos `managed-settings.json` en un directorio del sistema
520* Un host de incrustación como Claude Desktop, a través de la opción SDK `managedSettings`; vea [Controlar política desde un host de incrustación](/docs/es/managed-settings#parent-settings-from-embedding-hosts)520* Un host de incrustación como Claude Desktop, a través de la opción `managedSettings` del SDK; consulta [Controlar la política desde un host de incrustación](/docs/es/managed-settings#parent-settings-from-embedding-hosts)
521 521
522En una sesión de [Cowork](https://claude.com/docs/cowork/overview) que se ejecuta en su máquina en la aplicación Claude Desktop, Claude Code no obtiene configuraciones administradas por servidor de la consola de administrador de claude.ai, y lee la política implementada en su dispositivo a menos que la configuración de Claude Desktop de su organización establezca `requireCoworkFullVmSandbox`. [Dónde y cuándo se aplica una política](/docs/es/managed-settings#where-and-when-a-policy-applies) cubre Cowork y sesiones en la nube.522En una sesión de [Cowork](https://claude.com/docs/cowork/overview) que se ejecuta en tu máquina en la aplicación Claude Desktop, Claude Code no obtiene la configuración administrada por servidor de la consola de administración de claude.ai, y lee la política implementada en tu dispositivo a menos que la configuración de Claude Desktop de tu organización establezca `requireCoworkFullVmSandbox`. [Dónde y cuándo se aplica una política](/docs/es/managed-settings#where-and-when-a-policy-applies) cubre Cowork y las sesiones en la nube.
523 523
524Si es el administrador, [Configure Claude Code para su organización](/docs/es/admin-setup) lo guía a través de elegir qué aplicar, y [Implemente configuraciones administradas](/docs/es/managed-settings) cubre la entrega y cómo confirmar que una política está en vigor.524Si eres el administrador, [Configurar Claude Code para tu organización](/docs/es/admin-setup) te guía para elegir qué imponer, y [Implementar la configuración administrada](/docs/es/managed-settings) cubre la entrega y cómo confirmar que una política está en vigor. Para la advertencia que puede mostrar el editor de configuración administrada en la consola de administración de claude.ai, consulta [Configurar la configuración administrada por servidor](/docs/es/server-managed-settings#configure-server-managed-settings).
525 525
526<h2 id="change-a-setting">526<h2 id="change-a-setting">
527 Cambie una configuración527 Cambie una configuración
809 809
810Una [sesión en la nube](/docs/es/claude-code-on-the-web) se ejecuta en un [entorno en la nube](/docs/es/cloud-environments) en un clon fresco de su repositorio, no en su máquina. Eso cambia qué configuraciones lo alcanzan:810Una [sesión en la nube](/docs/es/claude-code-on-the-web) se ejecuta en un [entorno en la nube](/docs/es/cloud-environments) en un clon fresco de su repositorio, no en su máquina. Eso cambia qué configuraciones lo alcanzan:
811 811
812* **Configuraciones compartidas de proyecto** (`.claude/settings.json`): se leen en una sesión con un repositorio, porque el archivo es parte del clon y la sesión comienza dentro de él. Confirme una configuración allí para aplicarla en esas sesiones. Una sesión con varios repositorios comienza por encima de los clones y lee solo las claves `enabledPlugins` y `extraKnownMarketplaces` de cada `.claude/settings.json` del repositorio, no reglas de permisos, hooks, `env` u otras claves. Los mercados y plugins que esas dos claves declaran aún [no se cargan en una sesión en la nube](/docs/es/cloud-environments#what-carries-over-from-your-setup).812* **Configuraciones compartidas de proyecto** (`.claude/settings.json`): se leen en una sesión con un repositorio, porque el archivo es parte del clon y la sesión comienza dentro de él. Haz commit de un ajuste allí para aplicarlo en esas sesiones. En un entorno alojado por Anthropic, una sesión con varios repositorios comienza por encima de los clones y lee solo las claves `enabledPlugins` y `extraKnownMarketplaces` del `.claude/settings.json` de cada repositorio, no reglas de permisos, hooks, `env` u otras claves. Los marketplaces y plugins que esas dos claves declaran aún [no se cargan en una sesión en la nube](/docs/es/cloud-environments#what-carries-over-from-your-setup). Para un entorno autohospedado, consulta [qué configuración del repositorio se aplica](/docs/es/self-hosted-environments-configuration#repository-settings-in-sessions-with-several-repositories).
813* **Configuraciones de usuario y proyecto local** (`~/.claude/settings.json` y `.claude/settings.local.json`): no se leen. Ambas permanecen en su máquina, y el archivo local no está en el clon.813* **Configuraciones de usuario y proyecto local** (`~/.claude/settings.json` y `.claude/settings.local.json`): no se leen. Ambas permanecen en su máquina, y el archivo local no está en el clon.
814* **Configuraciones administradas**: un archivo `managed-settings.json` o perfil MDM en su dispositivo no alcanza una sesión en la nube. Las [configuraciones administradas por servidor](/docs/es/server-managed-settings) de su organización sí; [cobertura de superficie](/docs/es/model-config#surface-coverage) enumera qué sesiones en la nube las reciben. Un [entorno autohospedado](/docs/es/self-hosted-environments) también lee el archivo de configuraciones administradas en su imagen de ejecutor. [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) dice cuándo se aplica ese archivo.814* **Configuraciones administradas**: un archivo `managed-settings.json` o perfil MDM en su dispositivo no alcanza una sesión en la nube. Las [configuraciones administradas por servidor](/docs/es/server-managed-settings) de su organización sí; [cobertura de superficie](/docs/es/model-config#surface-coverage) enumera qué sesiones en la nube las reciben. Un [entorno autohospedado](/docs/es/self-hosted-environments) también lee el archivo de configuraciones administradas en su imagen de ejecutor. [Cómo Claude Code combina fuentes administradas](/docs/es/managed-settings#how-claude-code-combines-managed-sources) dice cuándo se aplica ese archivo.
815* **`/config`**: en su navegador en claude.ai/code, abre la sección Claude Code de su configuración de claude.ai en lugar de cambiar un valor. Para cambiar una configuración para una sesión en la nube, establezca una [variable de entorno](/docs/es/cloud-environments#set-environment-variables) en el entorno, o en una sesión con un repositorio, confirme la clave en el `.claude/settings.json` de ese repositorio.815* **`/config`**: en su navegador en claude.ai/code, abre la sección Claude Code de su configuración de claude.ai en lugar de cambiar un valor. Para cambiar una configuración para una sesión en la nube, establezca una [variable de entorno](/docs/es/cloud-environments#set-environment-variables) en el entorno, o en una sesión con un repositorio, confirme la clave en el `.claude/settings.json` de ese repositorio.