settings.json de ejemplo, uno para cada lugar donde guarda una configuración:
- Un
~/.claude/settings.jsonde desarrollador - Un
.claude/settings.jsonde equipo, confirmado en el repositorio - Un
managed-settings.jsonde organización
Su propia configuración
La configuración personal de un desarrollador. Elige un modelo y esfuerzo, ajusta la terminal y aprueba previamente un comando de solo lectura y una lectura de archivo. Todo lo que no aparece en la lista mantiene su valor predeterminado. Un archivo como este va en~/.claude/settings.json, donde se aplica a cada proyecto que abre.
- Archivo de configuración copiable
- Lo que hace cada clave
Guarde esto como
~/.claude/settings.json. Es JSON válido sin comentarios, así que puede pegarlo tal cual y eliminar las claves que no desee.~/.claude/settings.json
Configuración compartida de un equipo
La configuración compartida de un equipo, confirmada en el repositorio para que todos los que lo clonan obtengan los mismos permisos, hooks, telemetría y marketplace de plugins. Guarde un archivo como este en.claude/settings.json en la parte superior del repositorio. Tres cosas que debe saber antes de confirmar uno:
- Las sesiones en la nube también lo leen. Una sesión en la nube en Claude Code en la web comienza desde un clon del repositorio, por lo que el archivo confirmado también se aplica allí.
- Las reglas de permiso esperan confianza. Las reglas de permiso y las entradas de
extraKnownMarketplacesentran en vigor después de que cada persona confía en esta carpeta misma, no solo en una carpeta principal; las reglas de denegación y pregunta se aplican en cada sesión, confiable o no. - El hook es un script en el repositorio. El hook de este archivo ejecuta
.claude/hooks/block-rm.sh; Cómo se resuelve un hook explica cómo escribirlo.
- Archivo de configuración copiable
- Lo que hace cada clave
Guarde esto como
.claude/settings.json en la parte superior del repositorio y confírmelo. Es JSON válido sin comentarios, así que puede pegarlo tal cual y eliminar las claves que no desee..claude/settings.json
Configuración administrada de una organización
Un archivomanaged-settings.json que muestra la forma de las claves administradas, con un valor plausible para cada una. No es una política recomendada: elija las claves que coincidan con sus propios requisitos y establezca sus propios valores. El ejemplo establece estas claves:
forceLoginMethodyforceLoginOrgUUIDfijan el método de inicio de sesión y la organizaciónavailableModelsyenforceAvailableModelsrestringen qué modelos pueden usar las sesionespermissions.denybloquea dos lecturas de archivo ycurl, ydisableBypassPermissionsModeelimina el modo de permiso de omisiónallowManagedPermissionRulesOnlyyallowManagedMcpServersOnlyhacen que las listas de permisos administrados y MCP sean las únicas que se apliquenallowedMcpServersfija el servidor MCP por URLstrictKnownMarketplacespermite un marketplace de pluginssandboxcoloca los comandos en sandbox con una lista de permisos de red fija y sin reintento sin sandboxrequiredMinimumVersionestablece una versión mínima de Claude CodecleanupPeriodDaysacorta la retención de transcripciones de sesión y otros datos locales a siete díascompanyAnnouncementsmuestra un mensaje al inicio
managed-settings.json, o el mismo JSON a través de MDM o configuración administrada por servidor. Un archivo implementado se aplica a cada máquina o cuenta que alcanza. Para dar a un grupo valores diferentes, implemente un archivo o perfil diferente en ese grupo, ya que la configuración administrada por servidor aún no admite política por grupo.
- Archivo de configuración copiable
- Lo que hace cada clave
Implemente esto como
managed-settings.json, o el mismo JSON a través de MDM o la consola de claude.ai. Es JSON válido sin comentarios; reemplace el UUID de organización de ejemplo, la URL del servidor y el marketplace con los suyos propios y elimine las claves que no desee.managed-settings.json