Inicio/Configuración

⚙️ Configuración

Claude Code es altamente configurable. Aprende a personalizar su comportamiento, modelo, memoria y preferencias globales o por proyecto.

Archivo de configuración principal

Claude Code guarda su configuración en ~/.claude/settings.json(configuración global) y en .claude/settings.json dentro de cada proyecto (configuración local, tiene prioridad).

# Ver configuración actual dentro de Claude Code:
/config

# O editar directamente:
nano ~/.claude/settings.json

Ejemplo de settings.json

{
  "model": "claude-sonnet-4-6",
  "theme": "dark",
  "autoUpdates": true,
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git:*)",
      "Read(**)",
      "Edit(**)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "WebFetch(domain:evil.com)"
    ]
  },
  "env": {
    "NODE_ENV": "development"
  }
}
La configuración del proyecto (.claude/settings.json) sobreescribe la global. Puedes añadir este archivo al repositorio para compartir configuración con tu equipo.

CLAUDE.md — Memoria del proyecto

El archivo CLAUDE.md en la raíz de tu proyecto es la "memoria" de Claude Code. Cuando inicias una sesión, Claude lee este archivo automáticamente para entender el contexto de tu proyecto.

Crear CLAUDE.md automáticamente

# Dentro de Claude Code:
/init

Claude Code analizará tu proyecto y generará un CLAUDE.md con la estructura, stack tecnológico, comandos importantes y convenciones.

Estructura recomendada de CLAUDE.md

# Proyecto: Mi App

## Stack
- Frontend: Next.js 16 + TypeScript + Tailwind CSS
- Backend: Node.js + Express + PostgreSQL
- Tests: Vitest + Playwright

## Comandos esenciales
```bash
npm run dev          # Iniciar dev server (puerto 3000)
npm run test         # Ejecutar tests
npm run build        # Build de producción
npm run db:migrate   # Ejecutar migraciones
```

## Estructura del proyecto
- /app — Páginas Next.js (App Router)
- /components — Componentes reutilizables
- /lib — Utilidades y configuración
- /prisma — Schema de base de datos

## Convenciones
- Usa kebab-case para nombres de archivos
- Los componentes llevan sufijo .tsx
- Los tests van junto al archivo que prueban (*.test.ts)

## Notas importantes
- La rama main está protegida, trabaja en feature branches
- La DB local está en localhost:5432, usuario: dev, sin contraseña

Variables de entorno

Claude Code lee variables de entorno de tu shell. Las más importantes:

VariableDescripción
ANTHROPIC_API_KEYTu API key de Anthropic (obligatoria)
ANTHROPIC_MODELModelo por defecto para la sesión
ANTHROPIC_BASE_URLURL base para proxies o endpoints personalizados
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICDesactiva telemetría (pon 1)
NO_COLORDesactiva el color en la salida (pon 1)
CLAUDE_MAX_TOKENSTokens máximos por respuesta

Modelo por defecto

Puedes cambiar el modelo que Claude Code usa en cada sesión. El modelo por defecto es claude-sonnet-4-6 (equilibrio velocidad/calidad).

# En settings.json:
{ "model": "claude-opus-4-8" }

# O como variable de entorno:
export ANTHROPIC_MODEL="claude-opus-4-8"

# O al iniciar Claude Code:
claude --model claude-opus-4-8

Integración con VS Code

Instala la extensión Claude Code desde el Marketplace de VS Code. Tras instalarla, Claude Code aparece en el panel lateral y funciona con el mismo contexto de tu proyecto abierto.

  • Atajos de teclado: Cmd+Shift+P → "Claude Code"
  • Inline suggestions al escribir código
  • Panel de chat integrado con contexto del archivo activo
  • Diff view para revisar cambios propuestos

Integración con JetBrains

Disponible en el Marketplace de JetBrains para IntelliJ IDEA, PyCharm, WebStorm, etc. Mismas capacidades que la extensión de VS Code.

Configuración de proxy

Si trabajas detrás de un proxy corporativo:

export HTTPS_PROXY="https://proxy.empresa.com:8080"
export HTTP_PROXY="http://proxy.empresa.com:8080"
# Luego inicia Claude Code normalmente
claude

Múltiples perfiles / proyectos

Para usar diferentes API keys o configuraciones en distintos proyectos, crea un .claude/settings.json en cada proyecto con sus propios valores. Claude Code los detecta automáticamente.

← ComandosServidores MCP →