Configúralo como un pro: ajustes, modelo y atajos

Al acabar

Dejarás Claude Code configurado a tu gusto: en español, con el modelo y el esfuerzo que quieres, reglas de seguridad y atajos para arrancarlo.

Dónde están los ajustes

`~/.claude/settings.json`	Los tuyos, para todo. En Windows: `C:\Users\tunombre\.claude\settings.json`.
`.claude/settings.json`	Los de una carpeta, para compartir con tu equipo.
`.claude/settings.local.json`	Los tuyos para esa carpeta, sin compartir.

Instalar Claude Code no crea ninguno: aparecen cuando cambias algo. Si hay varios, mandan los de la carpeta sobre los tuyos, y las listas de permisos se suman.

`/config`	La pantalla de ajustes más habituales: tema, modelo, estilo... En la app de escritorio abre Settings > Code.
`/status`	Versión, modelo, cuenta y qué archivos de ajustes ha cargado.
`/update-config`	Le describes el cambio con palabras y Claude edita el archivo correcto.

Es JSON estricto: un comentario o una coma de más al final y da error. Lo más seguro es pedirle a Claude que lo edite y lo compruebe.

Configuración para empezar

~/.claude/settings.json · básica

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "language": "spanish",
  "outputStyle": "Explanatory",
  "cleanupPeriodDays": 90,
  "permissions": {
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)"]
  }
}

`language`	Te responde en español siempre.
`outputStyle`	`Explanatory` explica por qué hace cada cosa: ideal para aprender. `Learning` además te deja partes para que las hagas tú. Ojo: en el archivo van con mayúscula inicial, o no funcionan.
`cleanupPeriodDays`	Días que guarda conversaciones y puntos de control. De serie, 30.
`permissions.deny`	Archivos que no puede leer, como los de claves. Las reglas de permisos las hace cumplir el programa, no el modelo.

Configuración pro

~/.claude/settings.json · pro

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "language": "spanish",
  "model": "opus",
  "modelSettings": { "claude-opus-5-5": { "effortLevel": "high" } },
  "fallbackModel": ["sonnet"],
  "cleanupPeriodDays": 365,
  "permissions": {
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)"]
  }
}

`model`	El modelo con el que empieza cada conversación.
`modelSettings`	El esfuerzo por defecto de cada modelo. Para Opus 5.5 va aquí: el `effortLevel` suelto en tu archivo de usuario ya no se le aplica. Aquí no se acepta `max`, que solo dura una sesión.
`fallbackModel`	Qué modelo usar si el principal está saturado.
`permissions.ask`	Órdenes para las que siempre te pregunta, aunque estés en automático.

Más esfuerzo es mejor resultado, pero gasta más de tu límite. Con el plan Pro, mejor medium por defecto y subirlo solo cuando haga falta.

Si prefieres que arranque siempre en modo manual, añade dentro de permissions: "defaultMode": "default".

Atajos en la terminal

Los profesionales se hacen atajos para arrancar como quieren con dos letras. En Mac o Linux, al final de tu ~/.zshrc o ~/.bashrc:

~/.zshrc

# Atajos de Claude Code (al final de ~/.zshrc o ~/.bashrc)
alias ccplan='claude --permission-mode plan'
alias ccsigue='claude -c'
alias ccpro='claude --model opus --effort xhigh'

En Windows van en tu perfil de PowerShell (ábrelo con notepad $PROFILE; si no existe, te pregunta si crearlo):

perfil de PowerShell

# Atajos de Claude Code (perfil de PowerShell)
function ccplan  { claude --permission-mode plan @args }   # empieza planificando
function ccsigue { claude -c @args }                       # sigue la última conversación
function ccpro   { claude --model opus --effort xhigh @args }  # para lo difícil (gasta más)

En algunos Windows, PowerShell no carga el perfil porque tiene bloqueada la ejecución de scripts. Cambiar eso es un ajuste de seguridad: si te sale ese aviso, usa las órdenes completas (claude --permission-mode plan) y no lo toques sin entender qué hace.

Más ajustes útiles

`/statusline`	Una línea abajo con lo que quieras ver: «`/statusline muestra el modelo y cuánto llevo de contexto con una barra`».
`/theme`	Colores, incluidos temas para daltonismo.
`/voice`	Dictado por voz: mantén la barra espaciadora y habla. Admite español. El audio se envía a Anthropic para transcribirlo.
`/privacy-settings`	Si Anthropic puede usar tus conversaciones para entrenar (planes Pro, Max y Ultra).

Una trampa de dinero: si en tu ordenador hay una variable ANTHROPIC_API_KEY (de algún tutorial), Claude Code puede usar esa clave y cobrarte por uso en vez de usar tu plan. Si no sabes qué es, no la crees, y si Claude te pregunta si usarla, di que no.

Te toca

Deja tu configuración básica. Lo más seguro es pedírselo:

Pídeselo así

Añade a mi ~/.claude/settings.json: language spanish, outputStyle Explanatory, cleanupPeriodDays 90 y reglas deny para Read(./.env), Read(./.env.*) y Read(./secrets/**). Si el archivo ya tiene cosas, no borres nada y comprueba que el JSON es válido.

Después abre una conversación nueva y escribe /status.

Sabrás que te ha salido si:

En /status aparece tu archivo de ajustes en «Setting sources».
Claude te responde en español y explica lo que hace.
Lo que había antes en el archivo sigue ahí.

Si algo falla

Mi estilo de respuesta no cambia

En el archivo va con mayúscula inicial: Explanatory, no explanatory. Con /output-style explanatory da igual cómo lo escribas.

He puesto effortLevel y Opus sigue en medium

Para Opus 5.5, el esfuerzo por defecto va en modelSettings. O elígelo con /effort y pulsa Enter para guardarlo.

Comprueba que lo has pillado

Tres preguntas. Cada acierto suma 10 puntos.

1. ¿Dónde van tus ajustes para todas las carpetas?

2. ¿Qué estilo de respuesta explica por qué hace cada cosa?

3. ¿Dónde fijas el esfuerzo por defecto de Opus 5.5?

¿Terminada?

Márcala y suma 100 puntos. Tu avance se guarda en este navegador.

Llévate el kit pro

Unas instrucciones globales listas para pegar, la configuración recomendada, 8 skills hechas y una plantilla de CLAUDE.md para cada profesión. Gratis.

Ver el kit

Fuentes (documentación oficial, consultada el 5-nov-2026):