Descripción general de Claude Code

Instala NodeJS 18+, luego ejecuta:

npm install -g @anthropic-ai/claude-code

Claude Code es una herramienta de codificación basada en agentes que vive en tu terminal, comprende tu base de código y te ayuda a programar más rápido mediante comandos en lenguaje natural. Al integrarse directamente con tu entorno de desarrollo, Claude Code optimiza tu flujo de trabajo sin requerir servidores adicionales o configuraciones complejas.

Las capacidades clave de Claude Code incluyen:

• Editar archivos y corregir errores en toda tu base de código
• Responder preguntas sobre la arquitectura y lógica de tu código
• Ejecutar y corregir pruebas, linting y otros comandos
• Buscar en el historial de git, resolver conflictos de fusión y crear commits y PRs

​

Antes de comenzar

​

Verifica los requisitos del sistema

• Sistemas operativos: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows vía WSL
• Hardware: 4GB RAM mínimo
• Software:
  • Node.js 18+
  • git 2.23+ (opcional)
  • GitHub o GitLab CLI para flujos de trabajo de PR (opcional)
  • ripgrep (rg) para búsqueda mejorada de archivos (opcional)
• Red: Conexión a Internet requerida para autenticación y procesamiento de IA
• Ubicación: Disponible solo en países compatibles

​

Instalar y autenticar

​

Características principales y flujos de trabajo

Claude Code opera directamente en tu terminal, entendiendo el contexto de tu proyecto y tomando acciones reales. No es necesario agregar archivos manualmente al contexto - Claude explorará tu base de código según sea necesario.

​

Seguridad y privacidad por diseño

La seguridad de tu código es primordial. La arquitectura de Claude Code garantiza:

• Conexión API directa: Tus consultas van directamente a la API de Anthropic sin servidores intermedios
• Trabaja donde tú trabajas: Opera directamente en tu terminal
• Entiende el contexto: Mantiene conciencia de toda la estructura de tu proyecto
• Toma acción: Realiza operaciones reales como editar archivos y crear commits

​

De preguntas a soluciones en segundos

# Haz preguntas sobre tu base de código
claude
> ¿cómo funciona nuestro sistema de autenticación?

# Crea un commit con un solo comando
claude commit

# Soluciona problemas en múltiples archivos
claude "arregla los errores de tipo en el módulo de autenticación"

​

Inicializa tu proyecto

Para usuarios primerizos, recomendamos:

1. Inicia Claude Code con claude
2. Prueba un comando simple como resume este proyecto
3. Genera una guía CLAUDE.md del proyecto con /init
4. Pide a Claude que haga commit del archivo CLAUDE.md generado en tu repositorio

​

Usa Claude Code para tareas comunes

Claude Code opera directamente en tu terminal, entendiendo el contexto de tu proyecto y tomando acciones reales. No es necesario agregar archivos manualmente al contexto - Claude explorará tu base de código según sea necesario.

​

Comprende código desconocido

> ¿qué hace el sistema de procesamiento de pagos?
> encuentra dónde se verifican los permisos de usuario
> explica cómo funciona la capa de caché

​

Automatiza operaciones de Git

> haz commit de mis cambios
> crea un pr
> ¿qué commit agregó pruebas para markdown en diciembre?
> haz rebase en main y resuelve cualquier conflicto de fusión

​

Edita código de forma inteligente

> agrega validación de entrada al formulario de registro
> refactoriza el logger para usar la nueva API
> arregla la condición de carrera en la cola de trabajadores

​

Prueba y depura tu código

> ejecuta pruebas para el módulo de autenticación y corrige fallos
> encuentra y corrige vulnerabilidades de seguridad
> explica por qué esta prueba está fallando

​

Fomenta un pensamiento más profundo

Para problemas complejos, pide explícitamente a Claude que piense más profundamente:

> piensa sobre cómo deberíamos arquitectar el nuevo servicio de pagos
> piensa detenidamente sobre los casos extremos en nuestro flujo de autenticación

Claude Code mostrará cuando Claude esté utilizando pensamiento extendido (disponible en Claude Sonnet 3.7, Claude Opus 4). Puedes solicitar proactivamente a Claude que “piense” o “piense profundamente” para tareas que requieren más planificación. Te sugerimos que primero le cuentes a Claude sobre tu tarea y le permitas recopilar contexto de tu proyecto. Luego, pídele que “piense” para crear un plan.

​

Automatiza flujos de trabajo de CI e infraestructura

Claude Code viene con un modo no interactivo para ejecución sin interfaz. Esto es especialmente útil para ejecutar Claude Code en contextos no interactivos como scripts, pipelines y Github Actions.

Usa --print (-p) para ejecutar Claude en modo no interactivo. En este modo, puedes establecer la variable de entorno ANTHROPIC_API_KEY para proporcionar una clave API personalizada.

El modo no interactivo es especialmente útil cuando preconfigurar el conjunto de comandos que Claude puede usar:

export ANTHROPIC_API_KEY=sk_...
claude -p "actualiza el README con los últimos cambios" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Write --disallowedTools ...

​

Controla Claude Code con comandos

​

Comandos CLI

Banderas CLI:

• --print (-p): Imprimir respuesta sin modo interactivo
• --json: Devolver salida JSON en modo --print, útil para scripts y automatización
• --verbose: Habilitar registro detallado, muestra salida completa turno por turno (útil para depuración en modos de impresión e interactivo)
• --dangerously-skip-permissions: Omitir solicitudes de permisos

​

Comandos con barra diagonal

Controla el comportamiento de Claude dentro de una sesión:

​

Gestiona la memoria de Claude

Claude Code puede recordar tus preferencias entre sesiones, como pautas de estilo y comandos comunes en tu flujo de trabajo.

​

Determina el tipo de memoria

Claude Code ofrece tres ubicaciones de memoria, cada una con un propósito diferente:

Todos los archivos de memoria se cargan automáticamente en el contexto de Claude Code cuando se inicia.

​

Cómo Claude busca en las memorias

Claude Code lee las memorias recursivamente: comenzando en el cwd, Claude Code sube recursivamente hasta / y lee cualquier archivo CLAUDE.md o CLAUDE.local.md que encuentre. Esto es especialmente conveniente cuando trabajas en repositorios grandes donde ejecutas Claude Code en foo/bar/, y tienes memorias tanto en foo/CLAUDE.md como en foo/bar/CLAUDE.md.

​

Agrega memorias rápidamente con el atajo #

La forma más rápida de agregar una memoria es comenzar tu entrada con el carácter #:

# Siempre usa nombres de variables descriptivos

Se te pedirá que selecciones en qué archivo de memoria almacenar esto.

​

Edita memorias directamente con /memory

Usa el comando /memory durante una sesión para abrir cualquier archivo de memoria en tu editor del sistema para adiciones más extensas u organización.

​

Mejores prácticas para memorias

• Sé específico: “Usa indentación de 2 espacios” es mejor que “Formatea el código correctamente”.
• Usa estructura para organizar: Formatea cada memoria individual como un punto de lista y agrupa memorias relacionadas bajo encabezados markdown descriptivos.
• Revisa periódicamente: Actualiza las memorias a medida que tu proyecto evoluciona para asegurar que Claude siempre esté usando la información y el contexto más actualizados.

​

Gestiona permisos y seguridad

Claude Code utiliza un sistema de permisos por niveles para equilibrar potencia y seguridad:

​

Herramientas disponibles para Claude

Claude Code tiene acceso a un conjunto de herramientas potentes que le ayudan a entender y modificar tu base de código:

Las reglas de permisos pueden configurarse usando /allowed-tools o en configuración de permisos.

​

Protección contra inyección de prompts

La inyección de prompts es una técnica donde un atacante intenta anular o manipular las instrucciones de un asistente de IA insertando texto malicioso. Claude Code incluye varias salvaguardas contra estos ataques:

• Sistema de permisos: Las operaciones sensibles requieren aprobación explícita
• Análisis consciente del contexto: Detecta instrucciones potencialmente dañinas analizando la solicitud completa
• Sanitización de entrada: Previene la inyección de comandos procesando las entradas del usuario
• Lista de bloqueo de comandos: Bloquea comandos arriesgados que obtienen contenido arbitrario de la web como curl y wget

Mejores prácticas para trabajar con contenido no confiable:

1. Revisa los comandos sugeridos antes de aprobarlos
2. Evita canalizar contenido no confiable directamente a Claude
3. Verifica los cambios propuestos en archivos críticos
4. Reporta comportamiento sospechoso con /bug

​

Configura el acceso a la red

Claude Code requiere acceso a:

• api.anthropic.com
• statsig.anthropic.com
• sentry.io

Incluye estas URLs en la lista blanca cuando uses Claude Code en entornos containerizados.

​

Variables de entorno

Claude Code admite las siguientes variables de entorno para controlar su comportamiento:

​

Configura Claude Code

Configura Claude Code ejecutando claude config en tu terminal, o el comando /config cuando uses el REPL interactivo.

​

Opciones de configuración

Claude Code admite configuración global y a nivel de proyecto.

Para gestionar tus configuraciones, usa los siguientes comandos:

• Listar configuraciones: claude config list
• Ver una configuración: claude config get <clave>
• Cambiar una configuración: claude config set <clave> <valor>
• Agregar a una configuración (para listas): claude config add <clave> <valor>
• Eliminar de una configuración (para listas): claude config remove <clave> <valor>

Por defecto, config cambia tu configuración de proyecto. Para gestionar tu configuración global, usa la bandera --global (o -g).

​

Configuración global

Para establecer una configuración global, usa claude config set -g <clave> <valor>:

​

Opciones de permisos del actualizador automático

Cuando Claude Code detecta que no tiene permisos suficientes para escribir en tu directorio de prefijo npm global (requerido para actualizaciones automáticas), verás una advertencia que apunta a esta página de documentación. Para soluciones detalladas a problemas del actualizador automático, consulta la guía de solución de problemas.

​

Recomendado: Crear un nuevo prefijo npm escribible por el usuario

# Primero, guarda una lista de tus paquetes globales existentes para migración posterior
npm list -g --depth=0 > ~/npm-global-packages.txt

# Crea un directorio para tus paquetes globales
mkdir -p ~/.npm-global

# Configura npm para usar la nueva ruta de directorio
npm config set prefix ~/.npm-global

# Nota: Reemplaza ~/.bashrc con ~/.zshrc, ~/.profile u otro archivo apropiado para tu shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Aplica la nueva configuración de PATH
source ~/.bashrc

# Ahora reinstala Claude Code en la nueva ubicación
npm install -g @anthropic-ai/claude-code

# Opcional: Reinstala tus paquetes globales anteriores en la nueva ubicación
# Mira ~/npm-global-packages.txt e instala los paquetes que quieras mantener
# npm install -g paquete1 paquete2 paquete3...

Por qué recomendamos esta opción:

• Evita modificar permisos de directorios del sistema
• Crea una ubicación limpia y dedicada para tus paquetes npm globales
• Sigue las mejores prácticas de seguridad

Como Claude Code está en desarrollo activo, recomendamos configurar actualizaciones automáticas usando la opción recomendada anterior.

​

Deshabilitar el actualizador automático

Si prefieres deshabilitar el actualizador automático en lugar de arreglar permisos, puedes usar:

claude config set -g autoUpdaterStatus disabled

​

Configuración de proyecto

Gestiona la configuración del proyecto con claude config set <clave> <valor> (sin la bandera -g):

Por ejemplo:

# Permitir que npm test se ejecute sin aprobación
claude config add allowedTools "Bash(npm test)"

# Permitir que npm test y cualquiera de sus subcomandos se ejecuten sin aprobación
claude config add allowedTools "Bash(npm test:*)"

# Instruir a Claude para ignorar node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"

Consulta Permisos para el formato de reglas de allowedTools.

​

Optimiza tu configuración de terminal

Claude Code funciona mejor cuando tu terminal está configurado correctamente. Sigue estas pautas para optimizar tu experiencia.

Shells compatibles:

• Bash
• Zsh
• Fish

​

Temas y apariencia

Claude no puede controlar el tema de tu terminal. Eso lo maneja tu aplicación de terminal. Puedes hacer coincidir el tema de Claude Code con tu terminal durante la incorporación o en cualquier momento a través del comando /config

​

Saltos de línea

Tienes varias opciones para introducir saltos de línea en Claude Code:

• Escape rápido: Escribe \ seguido de Enter para crear una nueva línea
• Atajo de teclado: Presiona Option+Enter (Meta+Enter) con la configuración adecuada

Para configurar Option+Enter en tu terminal:

Para Mac Terminal.app:

1. Abre Configuración → Perfiles → Teclado
2. Marca “Usar Option como tecla Meta”

Para iTerm2 y terminal de VSCode:

1. Abre Configuración → Perfiles → Teclas
2. En General, establece la tecla Option izquierda/derecha a “Esc+”

Consejo para usuarios de iTerm2 y VSCode: Ejecuta /terminal-setup dentro de Claude Code para configurar automáticamente Shift+Enter como una alternativa más intuitiva.

​

Configuración de notificaciones

Nunca te pierdas cuando Claude complete una tarea con la configuración adecuada de notificaciones:

Notificaciones de campana de terminal

Habilita alertas de sonido cuando se completen tareas:

claude config set --global preferredNotifChannel terminal_bell

Para usuarios de macOS: No olvides habilitar los permisos de notificación en Configuración del Sistema → Notificaciones → [Tu aplicación de Terminal].

Notificaciones de sistema de iTerm 2

Para alertas de iTerm 2 cuando se completen tareas:

1. Abre Preferencias de iTerm 2
2. Navega a Perfiles → Terminal
3. Habilita “Silenciar campana” y “Enviar notificación cuando esté inactivo”
4. Establece tu retraso de notificación preferido

Ten en cuenta que estas notificaciones son específicas de iTerm 2 y no están disponibles en el Terminal predeterminado de macOS.

​

Manejo de entradas grandes

Cuando trabajes con código extenso o instrucciones largas:

• Evita pegar directamente: Claude Code puede tener dificultades con contenido pegado muy largo
• Usa flujos de trabajo basados en archivos: Escribe contenido en un archivo y pide a Claude que lo lea
• Ten en cuenta las limitaciones de VS Code: El terminal de VS Code es particularmente propenso a truncar pegados largos

​

Modo Vim

Claude Code admite un subconjunto de atajos de teclado de Vim que se pueden habilitar con /vim o configurar a través de /config.

El subconjunto compatible incluye:

• Cambio de modo: Esc (a NORMAL), i/I, a/A, o/O (a INSERT)
• Navegación: h/j/k/l, w/e/b, 0/$/^, gg/G
• Edición: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repetir)

​

Gestiona costos efectivamente

Claude Code consume tokens para cada interacción. El costo promedio es de $6 por desarrollador por día, con costos diarios que permanecen por debajo de $12 para el 90% de los usuarios.

​

Rastrea tus costos

• Usa /cost para ver el uso de la sesión actual
• Usuarios de Consola Anthropic:
  • Verifica el uso histórico en la Consola de Anthropic (requiere rol de Administrador o Facturación)
  • Establece límites de gasto del espacio de trabajo para el espacio de trabajo de Claude Code (requiere rol de Administrador)
• Usuarios del plan Max: El uso está incluido en tu suscripción al plan Max

​

Reduce el uso de tokens

• Compacta conversaciones:

  • Claude usa auto-compactación por defecto cuando el contexto excede el 95% de capacidad

  • Alterna auto-compactación: Ejecuta /config y navega a “Auto-compact enabled”

  • Usa /compact manualmente cuando el contexto se vuelve grande

  • Agrega instrucciones personalizadas: /compact Enfócate en ejemplos de código y uso de API

  • Personaliza la compactación agregando a CLAUDE.md:

    # Instrucciones de resumen
    
    Cuando uses compact, por favor enfócate en la salida de pruebas y cambios de código
    

• Escribe consultas específicas: Evita solicitudes vagas que desencadenen escaneos innecesarios

• Divide tareas complejas: Separa tareas grandes en interacciones enfocadas

• Limpia el historial entre tareas: Usa /clear para reiniciar el contexto

Los costos pueden variar significativamente según:

• Tamaño de la base de código que se analiza
• Complejidad de las consultas
• Número de archivos que se buscan o modifican
• Longitud del historial de conversación
• Frecuencia de compactación de conversaciones

​

Configuración del modelo

Por defecto, Claude Code usa claude-opus-4-20250514. Puedes anular esto usando las siguientes variables de entorno:

# API de Anthropic
ANTHROPIC_MODEL='claude-opus-4-20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-opus-4@20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

También puedes establecer estas variables usando la configuración global:

# Configurar para API de Anthropic
claude config set --global env '{"ANTHROPIC_MODEL": "claude-opus-4-20250514"}'

# Configurar para Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0"}'

# Configurar para Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-opus-4@20250514"}'

​

Uso con APIs de terceros

​

Conectar a Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Si deseas acceder a Claude Code a través de un proxy, puedes usar la variable de entorno ANTHROPIC_BEDROCK_BASE_URL:

ANTHROPIC_BEDROCK_BASE_URL='https://tu-url-de-proxy'

Si no tienes habilitado el almacenamiento en caché de prompts, también establece:

DISABLE_PROMPT_CACHING=1

Requiere credenciales estándar del SDK de AWS (por ejemplo, ~/.aws/credentials o variables de entorno relevantes como AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Para configurar credenciales de AWS, ejecuta:

aws configure

Contacta a Amazon Bedrock para el almacenamiento en caché de prompts para costos reducidos y límites de tasa más altos.

​

Conectar a Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=tu-id-de-proyecto

Si deseas acceder a Claude Code a través de un proxy, puedes usar la variable de entorno ANTHROPIC_VERTEX_BASE_URL:

ANTHROPIC_VERTEX_BASE_URL='https://tu-url-de-proxy'

Si no tienes habilitado el almacenamiento en caché de prompts, también establece:

DISABLE_PROMPT_CACHING=1

Requiere credenciales estándar de GCP configuradas a través de google-auth-library. Para configurar credenciales de GCP, ejecuta:

gcloud auth application-default login

Para la mejor experiencia, contacta a Google para obtener límites de tasa más altos.

​

Conectar a través de un proxy

Cuando uses Claude Code con un proxy LLM (como LiteLLM), puedes controlar el comportamiento de autenticación usando las siguientes variables de entorno y configuraciones. Ten en cuenta que puedes combinar estas con configuraciones específicas de Bedrock y Vertex.

​

Variables de entorno

• ANTHROPIC_AUTH_TOKEN: Valor personalizado para los encabezados Authorization y Proxy-Authorization (el valor que establezcas aquí tendrá el prefijo Bearer )
• ANTHROPIC_CUSTOM_HEADERS: Encabezados personalizados que quieres agregar a la solicitud (en formato Nombre: Valor)
• HTTP_PROXY: Establece la URL del proxy HTTP
• HTTPS_PROXY: Establece la URL del proxy HTTPS

Si prefieres configurar mediante un archivo en lugar de variables de entorno, puedes agregar cualquiera de estas variables al objeto env en tu configuración global de Claude (en ~/.claude.json).

​

Opciones de configuración global

• apiKeyHelper: Un script de shell personalizado para obtener una clave API (invocado una vez al inicio y almacenado en caché durante la sesión)

​

Implementación de referencia de contenedor de desarrollo

Claude Code proporciona una configuración de contenedor de desarrollo para equipos que necesitan entornos consistentes y seguros. Esta configuración de devcontainer preconfigurada funciona perfectamente con la extensión Remote - Containers de VS Code y herramientas similares.

Las medidas de seguridad mejoradas del contenedor (aislamiento y reglas de firewall) te permiten ejecutar claude --dangerously-skip-permissions para omitir las solicitudes de permisos para operación desatendida. Hemos incluido una implementación de referencia que puedes personalizar según tus necesidades.

​

Características clave

• Node.js listo para producción: Construido sobre Node.js 20 con dependencias de desarrollo esenciales
• Seguridad por diseño: Firewall personalizado que restringe el acceso de red solo a servicios necesarios
• Herramientas amigables para desarrolladores: Incluye git, ZSH con mejoras de productividad, fzf y más
• Integración perfecta con VS Code: Extensiones preconfiguradas y configuraciones optimizadas
• Persistencia de sesión: Preserva el historial de comandos y configuraciones entre reinicios de contenedor
• Funciona en todas partes: Compatible con entornos de desarrollo macOS, Windows y Linux

​

Comenzar en 4 pasos

1. Instala VS Code y la extensión Remote - Containers
2. Clona el repositorio de implementación de referencia de Claude Code
3. Abre el repositorio en VS Code
4. Cuando se te solicite, haz clic en “Reabrir en Contenedor” (o usa la Paleta de Comandos: Cmd+Shift+P → “Remote-Containers: Reopen in Container”)

​

Desglose de configuración

La configuración del devcontainer consta de tres componentes principales:

• devcontainer.json: Controla la configuración del contenedor, extensiones y montajes de volumen
• Dockerfile: Define la imagen del contenedor y las herramientas instaladas
• init-firewall.sh: Establece reglas de seguridad de red

​

Características de seguridad

El contenedor implementa un enfoque de seguridad multicapa con su configuración de firewall:

• Control de acceso preciso: Restringe las conexiones salientes solo a dominios en lista blanca (registro npm, GitHub, API de Anthropic, etc.)
• Política de denegación por defecto: Bloquea todo otro acceso de red externo
• Verificación de inicio: Valida las reglas de firewall cuando el contenedor se inicializa
• Aislamiento: Crea un entorno de desarrollo seguro separado de tu sistema principal

​

Opciones de personalización

La configuración del devcontainer está diseñada para adaptarse a tus necesidades:

• Agrega o elimina extensiones de VS Code según tu flujo de trabajo
• Modifica asignaciones de recursos para diferentes entornos de hardware
• Ajusta permisos de acceso a la red
• Personaliza configuraciones de shell y herramientas de desarrollo

​

Próximos pasos

​

Licencia y uso de datos

Claude Code se proporciona como una vista previa de investigación Beta bajo los Términos de Servicio Comerciales de Anthropic.

​

Cómo usamos tus datos

Nuestro objetivo es ser completamente transparentes sobre cómo usamos tus datos. Podemos usar comentarios para mejorar nuestros productos y servicios, pero no entrenaremos modelos generativos usando tus comentarios de Claude Code. Dada su naturaleza potencialmente sensible, almacenamos las transcripciones de comentarios de usuarios durante solo 30 días.

​

Transcripciones de comentarios

Si eliges enviarnos comentarios sobre Claude Code, como transcripciones de tu uso, Anthropic puede usar esos comentarios para depurar problemas relacionados y mejorar la funcionalidad de Claude Code (por ejemplo, para reducir el riesgo de que ocurran errores similares en el futuro). No entrenaremos modelos generativos usando estos comentarios.

​

Salvaguardas de privacidad

Hemos implementado varias salvaguardas para proteger tus datos, incluyendo períodos de retención limitados para información sensible, acceso restringido a datos de sesión de usuario y políticas claras contra el uso de comentarios para entrenamiento de modelos.

Para detalles completos, revisa nuestros Términos de Servicio Comerciales y Política de Privacidad.

​

Licencia

© Anthropic PBC. Todos los derechos reservados. El uso está sujeto a los Términos de Servicio Comerciales de Anthropic.