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": "sonnet",
  "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:

Variable	Descripción
`ANTHROPIC_API_KEY`	Tu API key de Anthropic (obligatoria)
`ANTHROPIC_MODEL`	Modelo por defecto para la sesión
`ANTHROPIC_BASE_URL`	URL base para proxies o endpoints personalizados
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Desactiva telemetría (pon 1)
`NO_COLOR`	Desactiva el color en la salida (pon 1)
`CLAUDE_MAX_TOKENS`	Tokens máximos por respuesta

Modelo por defecto

Puedes cambiar el modelo que Claude Code usa en cada sesión. El valor por defecto depende de tu cuenta y proveedor; para evitar IDs obsoletos, usa aliases como sonnet, opus o haiku.

# En settings.json:
{ "model": "opus" }

# O como variable de entorno:
export ANTHROPIC_MODEL="opus"

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

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.