Anthropic publicó más de 125 claves en el archivo settings.json de Claude Code. La documentación oficial cubre aproximadamente 40.
14 de las que faltan están a 3 clics de profundidad en la interfaz de Claude.ai. 4 de ellas no aparecen en ninguna documentación. Las encuentras leyendo issues de GitHub, viendo a ingenieros filtrarlas en Discord, o buscando en el binario de Claude Code a las 1am.
La mayoría de los usuarios de Claude usan lo que Anthropic lanzó hace seis meses. Su factura crece. Su rendimiento se desvía. Culpan al modelo.
A continuación: 18 configuraciones que realmente controlan tu Claude.
8 en Claude dot ai.
7 en Claude Code.
3 en API y Consola.
Para cada una: dónde está, qué hace, la solución en una línea.
Sección 1: Claude (8 configuraciones)
1. Memoria: alcance, exclusiones y el comando "olvida esto"
Dónde: Configuración → Capacidades → Memoria
Qué hace: La memoria se implementó para los planes Free y Pro en marzo de 2026. Por defecto, almacena todo lo que Claude decide que vale la pena guardar. Tres controles que la mayoría pasa por alto: alcance por proyecto, lista de exclusión y el comando para olvidar sobre la marcha.
Por qué importa: la memoria por defecto se desvía. Después de 4 a 6 semanas, está llena de correcciones puntuales ("prefiero tabs en Python", dijiste una vez sobre un archivo), datos específicos de proyectos que se filtran a chats no relacionados y contexto de rol obsoleto. La calidad del resultado disminuye porque Claude ahora está optimizando para el "tú" equivocado.
La solución:
- Activa la memoria por proyecto: Configuración → Capacidades → Memoria → Alcance por Proyecto. Los recuerdos dentro de un Proyecto se quedan en ese Proyecto. Esto solo soluciona la mayoría de las desviaciones.
- Añade a la lista de exclusión cualquier tema que no quieras que aparezca en chats no relacionados. Ejemplos: divorcio, temas médicos, cifras salariales, nombres de clientes. Estos persisten sin importar el contexto a menos que se excluyan.
- Usa el comando para olvidar en cualquier chat: olvida lo que recordaste sobre [tema]
Claude lo procesa comparando con tu almacén de memoria y confirma lo que eliminó. Sin menús, sin páginas de configuración.
2. Pensamiento Extendido: activación por chat
Dónde: entrada de chat → menú desplegable del selector de modelo → Pensamiento Extendido: Desactivado / Ligero / Completo
Qué hace: El Pensamiento Extendido añade una pasada de razonamiento <thinking> antes de la respuesta. Anthropic lo activa por defecto para Opus. El interruptor de tres estados es por chat y anula la configuración global.
Por qué importa: El Pensamiento Extendido es excelente para matemáticas, depuración y planificación de múltiples pasos. Es innecesario para resúmenes, traducciones, formato, reescrituras y consultas rápidas. En esas tareas añade de 3 a 12 segundos de latencia y entre un 20 y 40% más de tokens para la misma respuesta.
La solución: establece el valor predeterminado en Ligero (usa el pensamiento solo cuando el modelo lo considere útil) y cambia explícitamente a Completo para trabajos complejos. La mayoría de los usuarios a los que les muestro esto reducen su gasto de tokens de Opus entre un 18 y un 25% en la primera semana.
3. Estilos Personalizados: no es una "voz", sino contratos de resultado reales
Dónde: entrada de chat → selector de estilo → Crear Nuevo Estilo
Qué hace: Los Estilos comenzaron como un interruptor de tono ("Formal / Conciso / Explicativo"). Los Estilos Personalizados son en realidad un contrato de resultado. Pegas un archivo de instrucciones de 200 a 1500 palabras. Cada respuesta en ese estilo lo aplica antes de la generación.
Por qué importa: la mayoría usa los Estilos para "hacerlo más corto". El uso real es imponer reglas estructurales en cada respuesta sin tener que volver a pegarlas. Formato de citas. Palabras prohibidas. Secciones requeridas. Idiomas en bloques de código. Límites de longitud. Si hacer preguntas de seguimiento.
La solución: crea un Estilo por flujo de trabajo. Los míos:
Tres de estos en rotación (Borrador para X, Revisión de código, Resumir PDF) reemplazan el 80% de mis prompts guardados.
4. Proyectos: el campo de "instrucciones" que la mayoría deja vacío
Dónde: cualquier Proyecto → ⋯ en la esquina superior derecha → Editar instrucciones del proyecto
Qué hace: Los Proyectos son espacios de trabajo persistentes. El campo de instrucciones es un equivalente de system-prompt que se inyecta en cada chat de ese Proyecto. Anthropic presenta los Proyectos con la función de subida de conocimiento, que es lo que la gente recuerda. El campo de instrucciones está en la misma página y el 70% de los Proyectos que veo en el mundo real lo tienen en blanco.
Por qué importa: cada chat en un Proyecto comienza frío sin él. Con él, dejas de restablecer el contexto. ("Este es un flujo de trabajo de investigación de Polymarket. Escéptico por defecto. Muestra siempre las probabilidades matemáticas. Nunca recomiendes una operación, solo enmarca el EV.")
La solución: trátalo como un CLAUDE.md para Claude. Mantenlo por debajo de las 400 palabras. Especifica el rol, el nivel de escepticismo predeterminado, las reglas de formato y lo que nunca debe hacer. Vuelve a leerlo una vez al mes y recórtalo.
5. Buscar en chats pasados (Pro+) y cómo buscar realmente
Dónde: Configuración → Perfil → Buscar en chats pasados (debe estar activado)
Qué hace: permite a Claude buscar en tu historial de conversaciones cuando sea relevante. Solo Pro+.
Por qué importa: desactivado por defecto para cuentas nuevas incluso en Pro. Una vez activado, el truco es saber que hace coincidencia de palabras clave, no semántica. "¿Qué discutimos ayer sobre los robots chinos?" no devuelve nada a menos que tu chat pasado contenga literalmente "robots chinos" o "China" y "robots".
La solución: actívalo. Luego aprende la forma real de la consulta. Sustantivos de contenido, no palabras meta. "Polymarket Irán" funciona. "Eso de lo que hablamos la semana pasada" no.
6. Búsqueda web: activación por conversación y el comportamiento de las citas
Dónde: entrada de chat → + → Búsqueda web: Activada / Desactivada
Qué hace: el interruptor de búsqueda web es por conversación, pero el comportamiento cambia según una opción menos conocida en Configuración → Capacidades → Citas de búsqueda web: En línea / Notas al pie / Ocultas.
Por qué importa: el valor predeterminado es En línea. Las citas en línea rompen el copiar y pegar. Cuando copias la respuesta de Claude en otro lugar, copias marcadores que no apuntan a nada. El modo Notas al pie mantiene la respuesta limpia y enumera las fuentes al final.
La solución: cambia a Notas al pie si alguna vez copias las respuestas de búsqueda web de Claude a otro documento, correo electrónico o mensaje. Mantén En línea solo si lees todo dentro de Claude.
7. Conexiones: la trampa de "confiar en esta carpeta" en Cowork
Dónde: Configuración → Conexiones → Cowork → Carpetas de confianza
Qué hace: Cowork (disponible de forma general en abril de 2026) le da a Claude acceso a una carpeta en tu máquina. Por defecto, Anthropic pregunta antes de cada sesión si se debe confiar en la carpeta. La lista de carpetas de confianza es la manera de evitarlo.
Por qué importa: una vez que una carpeta está en la lista de confianza, Claude la lee en cada sesión de Cowork sin preguntar. Si añadiste una carpeta durante una prueba en marzo y lo olvidaste, Claude la ha estado leyendo en silencio en cada sesión desde entonces.
La solución: abre las carpetas de confianza. Elimina cualquier cosa que no sea un proyecto activo actual. La lista crece más rápido de lo que esperas.
8. Modo incógnito y lo que realmente omite
Dónde: barra lateral → Nuevo chat de incógnito (o Cmd/Ctrl + Mayús + N)
Qué hace: un chat de incógnito no se guarda, no se memoriza, no se puede buscar y no se usa para mejorar el modelo. El chat se elimina cuando lo cierras.
Por qué importa: la gente asume que el modo incógnito solo oculta el chat de la barra lateral. En realidad, omite cuatro sistemas: escritura de memoria, historial de chat, índice de búsqueda de chats pasados y la opción de datos de entrenamiento (si la tienes activada).
La solución: úsalo deliberadamente para cualquier cosa con datos confidenciales: salario, temas médicos, familiares, borradores legales, nombres de clientes. Tres pulsaciones de teclas, sin pensar.
Sección 2: Claude Code (7 configuraciones)
Estas viven en ~/.claude/settings.json (a nivel de usuario) o .claude/settings.json (a nivel de proyecto). Este último tiene prioridad.
Hay más de 125 claves en total en el binario v2.1.105. Las siete siguientes son las que realmente marcan la diferencia.
9. enabledPlugins: deshabilita, no desinstales
Dónde: ~/.claude/settings.json → enabledPlugins
Qué hace: establece qué plugins instalados se cargan al iniciar la sesión. El mercado de plugins facilita la instalación. La desinstalación es más difícil e innecesaria si solo estableces el valor en falso.
Por qué importa: cada plugin activo carga sus hooks, el contenido de SKILL.md y los esquemas de herramientas en tu presupuesto de contexto. Tres plugins que olvidaste = de 3 a 8K tokens de cargo previo antes de haber escrito nada.
Tenía 14 plugins activados cuando empecé esta auditoría. Ahora tengo 4 activos.
La solución:
falso mantiene el plugin instalado pero sin cargar. Vuelve a activarlo por sesión con /plugin enable nombre@marketplace cuando realmente lo necesites.
10. permissions.deny: lo que debes saber sobre el error
Dónde: ~/.claude/settings.json → permissions.deny
Qué hace: bloquea a Claude para que no ejecute herramientas específicas o acceda a archivos específicos. La intención: evitar rm -rf, evitar leer .env, evitar escribir fuera del proyecto.
Por qué importa: hay un error conocido. Las reglas de denegación a veces no bloquean. Múltiples issues en GitHub reportados. El más citado (anthropics/claude-code#11544) documenta hooks que no se cargan a pesar de una configuración válida; un patrón similar afecta la aplicación de las denegaciones. La regla está en tu configuración. El registro de depuración muestra "0 matchers found." Claude lee el archivo de todos modos.
La solución:
Añade una segunda capa a nivel del sistema de archivos. chmod 600 .env para que incluso si Claude intenta leerlo, el sistema operativo lo rechace. No confíes solo en la lista de denegación. Verifica con /permissions dentro de Claude Code. Si tus reglas no aparecen, reinicia la sesión.
11. hooks.SessionStart: las 4 líneas que redujeron mi inflación de contexto en un 30%
Dónde: ~/.claude/settings.json → hooks.SessionStart
Qué hace: SessionStart se activa cuando abres Claude Code en un directorio. Puedes ejecutar cualquier cosa: imprimir información del entorno, lint del estado de git, inyectar un archivo de contexto, calentar la caché.
Por qué importa: la mayoría inyecta demasiado. CLAUDE.md crece a 5K tokens porque se incluyeron todas las reglas del proyecto. SessionStart te permite cargar solo las reglas relevantes para la rama o el directorio actual.
La solución:
Tu rama main carga context-main.md. Tu rama feat/auth carga context-feat-auth.md. Cada archivo se mantiene pequeño. El presupuesto de contexto deja de sangrar.
12. disableAllHooks: el interruptor de pánico
Dónde: ~/.claude/settings.json → disableAllHooks: true
Qué hace: deshabilita todos los hooks con un solo interruptor. Se implementó en la actualización de marzo de 2026. La mayoría no sabe que existe.
Por qué importa: cuando Claude Code comienza a comportarse de manera extraña (comandos fantasma ejecutándose, sesiones que se quedan colgadas al inicio, escrituras misteriosas de archivos), el 80% de las veces es un hook que funciona mal. Deshabilitar los hooks uno por uno es lento. Esto los mata a todos a la vez para que puedas aislar el problema.
La solución: mantenlo en falso. Cuando algo se rompa, cámbialo a verdadero, reinicia y comprueba si el problema desaparece. Si es así, vuelve a habilitar los hooks uno por uno. Si no, el error está en otro lugar.
13. model: anulación por proyecto
Dónde: .claude/settings.json (raíz del proyecto) → model
Qué hace: establece el modelo predeterminado para ese proyecto. Anula tu configuración global.
Por qué importa: la mayoría configura Opus de forma global porque lo quieren para trabajos difíciles. Luego abren un proyecto que es principalmente edición de Markdown o scripts de shell. Pagan tarifas de Opus por tareas que Haiku hace a 1/20 del costo.
La solución:
Las anulaciones a nivel de proyecto ganan. Abre el proyecto, obtén el modelo correcto. Sigue adelante.
14. mcpServers con el indicador enabled
Dónde: ~/.claude/settings.json → mcpServers
Qué hace: los servidores MCP conectan a Claude con herramientas externas. Cada servidor conectado carga su esquema de herramientas completo en tu contexto. Entre 800 y 6,000 tokens por servidor.
Por qué importa: la gente conecta servidores MCP para probar y nunca los desconecta. Después de tres meses tienes 12 conectados, de los cuales usas activamente 3. Los 9 servidores no utilizados te cuestan entre ~25 y 40K tokens de esquema de contexto en cada inicio de sesión.
La solución: usa el indicador enabled para mantener la conexión configurada pero sin cargar.
Actívalo por sesión cuando realmente los necesites. La mayoría de los días tengo 2-3 activos. En días de planificación, 6.
15. cleanupPeriodDays: la caché que nadie menciona
Dónde: ~/.claude/settings.json → cleanupPeriodDays
Qué hace: establece cuántos días Claude Code conserva las transcripciones, los registros de depuración y los datos de sesión intermedios. El valor predeterminado es 30.
Por qué importa: Dreaming y la búsqueda en chats pasados dependen de estas transcripciones. Con la ventana predeterminada de 30 días, Dreaming solo puede aprender de un mes de trabajo. Seis meses le dan 6 veces más señal. Coste de disco: aproximadamente 200 MB.
La solución:
180 días de historial de sesiones disponibles para Dreaming, para la consolidación de la memoria y para tu propio grep cuando estés buscando "¿qué le dije a Claude sobre ese error de autenticación en marzo?"
El artefacto de Claude Code: un settings.json con las 7 configuraciones aplicadas
Copia esto en ~/.claude/settings.json. Ajusta las rutas y los nombres de los plugins a los tuyos. Reinicia Claude Code. Vuelve a ejecutar /permissions y /hooks para verificar que todo se cargó.
Las anulaciones a nivel de proyecto van en .claude/settings.json en la raíz del proyecto. La más útil para establecer allí:
Sección 3: API y Consola (3 configuraciones)
Estas viven en el código o en la Consola de Anthropic. Son las configuraciones con mayor impacto en el coste de este artículo. Cada una puede cambiar tu factura entre un 30 y un 90%.
16. Puntos de interrupción de cache_control: dónde colocarlos
Dónde: cuerpo de la solicitud API, campo cache_control en cualquier bloque de contenido
Qué hace: marca un prefijo de tu prompt como almacenable en caché. Las solicitudes posteriores con el mismo prefijo se cobran aproximadamente al 10% de la tarifa de entrada en lugar de la tarifa completa.
Por qué importa: esta es la palanca de costes más importante en la API. La gente sabe que existe. La mayoría coloca el punto de interrupción incorrectamente y obtiene ahorros parciales en lugar de completos. En mi propia configuración, arreglar el punto de interrupción redujo una factura de $340/mes a $87.
La solución: el punto de interrupción va en el límite entre el contenido estático y el dinámico. Todo lo que esté antes del punto de interrupción se almacena en caché. Todo lo que esté después se recalcula.
Hay dos TTL disponibles: efímero de 5 minutos (predeterminado) y de 1 hora. Usa 1 hora para los prompts del sistema que no cambian entre sesiones:
Las escrituras en caché cuestan un 25% más que la entrada base. Las lecturas de caché cuestan un 10% de la entrada base. El punto de equilibrio: un prefijo almacenado en caché se amortiza si lo lees 2 o más veces dentro de la ventana TTL.
17. inference_geo y el impuesto de residencia de datos
Dónde: Solicitud API → parámetro inference_geo
Qué hace: enruta la inferencia a una región geográfica específica. Residencia exclusiva en EE. UU., exclusiva en la UE, etc.
Por qué importa: la residencia de datos solo en EE. UU. añade una prima del 10% en Opus 4.7 y superiores. No está en la tarjeta de precios estándar. Lo ves en la factura.
La solución: si tu régimen de cumplimiento no requiere realmente la residencia regional, no establezcas inference_geo. La mayoría de las aplicaciones lo configuran "para estar seguros" porque alguien en el departamento legal dijo "asegúrate de que los datos se queden en EE. UU." Verifica si el requisito es contractual o aspiracional. Si es aspiracional, omite el parámetro y ahorra un 10% en cada llamada de Opus.
Si realmente lo necesitas, incluye el 10% en tu selección de modelo. Sonnet a $3 base se convierte efectivamente en $3.30, lo que cambia el punto de equilibrio entre Opus y Sonnet.
18. Límite de velocidad a nivel de espacio de trabajo (el que evita la interrupción de las 3am)
Dónde: Consola → Configuración → Espacios de trabajo → [tu espacio de trabajo] → Límites de velocidad por función
Qué hace: establece un límite de velocidad por espacio de trabajo, por función, separado de tus límites a nivel de cuenta.
Por qué importa: un límite a nivel de cuenta te protege de la ruina. Un límite a nivel de espacio de trabajo protege tu producto interactivo cuando un trabajo por lotes descontrolado intenta consumir todo tu margen de ITPM. Lanzas una nueva función, tiene un error, se repite en bucle, lo consume todo, tu chat de atención al cliente empieza a devolver errores 429. Los límites del espacio de trabajo evitan que una función prive a otra.
La solución: crea un espacio de trabajo por superficie (chat interactivo, procesamiento por lotes, herramientas internas, experimental). Establece el límite de velocidad de cada espacio de trabajo entre el 60 y el 70% de tu nivel de cuenta. Reserva el 30% para el espacio de trabajo que necesite un aumento repentino.
La cuarta configuración no documentada en este artículo: hay un límite a nivel de función dentro de cada espacio de trabajo que solo es visible si haces clic en una tarjeta de función específica, no en la vista general del espacio de trabajo. Valor predeterminado = ilimitado.
Si tienes tres funciones en un espacio de trabajo, una de ellas puede privar a las otras dos y el límite a nivel de espacio de trabajo no lo detectará. Establece límites por función para cualquier cosa que haga trabajo por lotes.
Sección 4: La lista de verificación de 18 puntos
Revísala una vez. 20 minutos. Cualquier cosa que no toques en 12 meses, probablemente nunca lo harás.
Sección 5: El script de auditoría (ejecútalo semanalmente)
Pon esto en ~/bin/claude-audit.sh. Ejecútalo semanalmente. Marca la mitad de Claude Code de la lista de verificación más el lado de cache_control de la mitad de la API.
Guárdalo, chmod +x ~/bin/claude-audit.sh, ejecútalo semanalmente hasta que cada línea esté en el objetivo.
Sección 6: Lo que no llegó a la lista
Eliminé cuatro candidatos antes de publicar. Vale la pena mencionarlos para que no pierdas tiempo buscándolos.
Interruptor de razonamiento adaptativo. Anthropic lo lanzó activado por defecto. La anulación existe en Configuración → Capacidades → Modo de razonamiento. En 30 días de comparación, no pude encontrar un flujo de trabajo donde anularlo cambiara los resultados de manera significativa. Confía en el valor predeterminado. Sigue adelante.
Autoactivación de habilidades. Puedes activar o desactivar si Claude carga automáticamente las habilidades según la detección de relevancia o si requiere una invocación explícita. Esperaba que esto importara. No fue así. La autoactivación con divulgación progresiva (cargar solo los metadatos de SKILL.md hasta que sea necesario) está bien ajustada. Déjalo activado.
Control de envío de móvil a escritorio. Función útil, no es un elemento de auditoría de configuración. O tienes un flujo de trabajo donde esto encaja o no. Ningún interruptor oculto cambia el resultado.
Límite máximo de tokens por espacio de trabajo. Puedes forzar que cada respuesta se trunque a 800, 2000 o 4000 tokens. Ahorra dinero real en flujos de trabajo charlatanes, pero corrompe la generación de código que necesita resultados largos. Vale la pena probarlo por espacio de trabajo. No vale la pena recomendarlo como valor predeterminado.
F I N
Revisa la lista de verificación esta noche. La mayoría de vosotros arreglaréis entre 6 y 8 cosas. Unos pocos arreglaréis 14 o más. Los números en tu panel de facturación y tu gráfico de uso te dirán si valió la pena los 20 minutos.
Guarda la lista de verificación y revísala esta noche. Si te ahorra un mes de frustración con "Claude se volvió más tonto", compártelo de nuevo. Telegram para consejos diarios de IA: https://t.me/+_ZWrQN7GuDA3ZDEy
![[Edición Definitiva] Un análisis profundo de Recruit Holdings por un ex empleado (escrito por mí, no por IA)](/cdn-cgi/image/width=1920,quality=90,format=auto,metadata=none/https%3A%2F%2Fcms-assets.youmind.com%2Fmedia%2F1783619810056_4fyuz8_HMtxHM_bIAA-0_J.jpg)
