Descripción general de Claude Code
Aprende sobre Claude Code, una herramienta de codificación con capacidad de agente creada por Anthropic. Actualmente en beta como vista previa de investigación.
NO uses sudo npm install -g
ya que esto puede llevar a problemas de permisos y
riesgos de seguridad. Si encuentras errores de permisos, consulta configurar Claude
Code para las soluciones recomendadas.
Claude Code es una herramienta de codificación con capacidad de agente que vive en tu terminal, entiende tu base de código y te ayuda a programar más rápido a través de comandos en lenguaje natural. Al integrarse directamente con tu entorno de desarrollo, Claude Code optimiza tu flujo de trabajo sin requerir servidores adicionales o una configuración compleja.
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
Vista previa de investigación
Code está en beta como vista previa de investigación. Estamos recopilando comentarios de desarrolladores sobre preferencias de colaboración con IA, qué flujos de trabajo se benefician más de la asistencia de IA y cómo mejorar la experiencia del agente.
Esta versión temprana evolucionará según los comentarios de los usuarios. Planeamos mejorar la fiabilidad de ejecución de herramientas, el soporte para comandos de larga duración, la renderización de terminal y el autoconocimiento de Claude sobre sus capacidades en las próximas semanas.
Reporta errores directamente con el comando /bug
o a través de nuestro repositorio de GitHub.
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:
- Red: Conexión a Internet requerida para autenticación y procesamiento de IA
- Ubicación: Disponible solo en países soportados
Solución de problemas de instalación en WSL
Actualmente, Claude Code no se ejecuta directamente en Windows y requiere WSL. Si encuentras problemas en WSL:
-
Problemas de detección de OS/plataforma: Si recibes un error durante la instalación, WSL puede estar usando
npm
de Windows. Intenta:- Ejecutar
npm config set os linux
antes de la instalación - Instalar con
npm install -g @anthropic-ai/claude-code --force --no-os-check
(NO usessudo
)
- Ejecutar
-
Errores de Node no encontrado: Si ves
exec: node: not found
al ejecutarclaude
, tu entorno WSL puede estar usando una instalación de Node.js de Windows. Puedes confirmarlo conwhich npm
ywhich node
, que deberían apuntar a rutas de Linux comenzando con/usr/
en lugar de/mnt/c/
. Para arreglarlo, intenta instalar Node a través del gestor de paquetes de tu distribución Linux o víanvm
.
Instalar y autenticar
Instalar Claude Code
Ejecuta en tu terminal: npm install -g @anthropic-ai/claude-code
NO uses sudo npm install -g
ya que esto puede llevar a problemas de permisos y
riesgos de seguridad. Si encuentras errores de permisos, consulta configurar Claude
Code para las soluciones recomendadas.
Navega a tu proyecto
cd tu-directorio-proyecto
Inicia Claude Code
claude
para iniciarCompleta la autenticación
Sigue el proceso de OAuth por única vez con tu cuenta de Console. Necesitarás facturación activa en console.anthropic.com.
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. Claude Code usa claude-3-7-sonnet-20250219
por defecto.
Seguridad y privacidad por diseño
La seguridad de tu código es primordial. La arquitectura de Claude Code asegura:
- 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
Inicializa tu proyecto
Para usuarios primerizos, recomendamos:
- Inicia Claude Code con
claude
- Prueba un comando simple como
resume este proyecto
- Genera una guía CLAUDE.md del proyecto con
/init
- Pide a Claude que haga commit del archivo CLAUDE.md generado a 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.
Entiende código desconocido
Automatiza operaciones de Git
Edita código inteligentemente
Prueba y depura tu código
Fomenta el pensamiento profundo
Para problemas complejos, pide explícitamente a Claude que piense más profundamente:
Claude Code mostrará cuando Claude (3.7 Sonnet) esté usando pensamiento extendido. Puedes proactivamente pedirle a Claude que “piense” o “piense profundamente” para tareas que requieren más planificación. Sugerimos que primero le cuentes a Claude sobre tu tarea y dejes que recopile contexto de tu proyecto. Luego, pídele que “piense” para crear un plan.
Claude pensará más según las palabras que uses. Por ejemplo, “piensa detenidamente” activará más pensamiento extendido que decir solo “piensa”.
Para más consejos, consulta Consejos de pensamiento extendido.
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 preconfiguras el conjunto de comandos que Claude puede usar:
Controla Claude Code con comandos
Comandos CLI
Comando | Descripción | Ejemplo |
---|---|---|
claude | Iniciar REPL interactivo | claude |
claude "consulta" | Iniciar REPL con prompt inicial | claude "explica este proyecto" |
claude -p "consulta" | Ejecutar consulta única, luego salir | claude -p "explica esta función" |
cat archivo | claude -p "consulta" | Procesar contenido canalizado | cat logs.txt | claude -p "explica" |
claude config | Configurar ajustes | claude config set --global theme dark |
claude update | Actualizar a la última versión | claude update |
claude mcp | Configurar servidores Model Context Protocol | Ver sección MCP en tutoriales |
Banderas CLI:
--print
: Imprimir respuesta sin modo interactivo--verbose
: Habilitar registro detallado--dangerously-skip-permissions
: Omitir solicitudes de permisos (solo en contenedores Docker sin internet)
Comandos con barra diagonal
Controla el comportamiento de Claude dentro de una sesión:
Comando | Propósito |
---|---|
/bug | Reportar errores (envía la conversación a Anthropic) |
/clear | Limpiar historial de conversación |
/compact | Compactar conversación para ahorrar espacio de contexto |
/config | Ver/modificar configuración |
/cost | Mostrar estadísticas de uso de tokens |
/doctor | Verifica la salud de tu instalación de Claude Code |
/help | Obtener ayuda de uso |
/init | Inicializar proyecto con guía CLAUDE.md |
/login | Cambiar cuentas de Anthropic |
/logout | Cerrar sesión de tu cuenta de Anthropic |
/pr_comments | Ver comentarios de pull request |
/review | Solicitar revisión de código |
/terminal-setup | Instalar atajo Shift+Enter para nuevas líneas (solo iTerm2 y VSCode) |
/vim | Entrar en modo vim para alternar modos de inserción y comando |
Gestiona permisos y seguridad
Claude Code usa un sistema de permisos por niveles para equilibrar poder y seguridad:
Tipo de herramienta | Ejemplo | Aprobación requerida | Comportamiento “Sí, no preguntar de nuevo” |
---|---|---|---|
Solo lectura | Lecturas de archivo, LS, Grep | No | N/A |
Comandos Bash | Ejecución de shell | Sí | Permanentemente por directorio de proyecto y comando |
Modificación de archivos | Editar/escribir archivos | Sí | Hasta el final de la sesión |
Herramientas disponibles para Claude
Claude Code tiene acceso a un conjunto de herramientas poderosas que le ayudan a entender y modificar tu base de código:
Herramienta | Descripción | Permiso requerido |
---|---|---|
AgentTool | Ejecuta un sub-agente para manejar tareas complejas de múltiples pasos | No |
BashTool | Ejecuta comandos shell en tu entorno | Sí |
GlobTool | Encuentra archivos basado en coincidencia de patrones | No |
GrepTool | Busca patrones en contenidos de archivos | No |
LSTool | Lista archivos y directorios | No |
FileReadTool | Lee contenidos de archivos | No |
FileEditTool | Hace ediciones específicas a archivos específicos | Sí |
FileWriteTool | Crea o sobrescribe archivos | Sí |
NotebookReadTool | Lee y muestra contenidos de notebooks Jupyter | No |
NotebookEditTool | Modifica celdas de notebooks Jupyter | Sí |
Protege 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 entradas de usuario
- Lista negra de comandos: Bloquea comandos riesgosos que obtienen contenido arbitrario de la web como
curl
ywget
Mejores prácticas para trabajar con contenido no confiable:
- Revisa los comandos sugeridos antes de aprobarlos
- Evita canalizar contenido no confiable directamente a Claude
- Verifica cambios propuestos a archivos críticos
- Reporta comportamiento sospechoso con
/bug
Si bien estas protecciones reducen significativamente el riesgo, ningún sistema es completamente inmune a todos los ataques. Mantén siempre buenas prácticas de seguridad cuando trabajes con cualquier herramienta de IA.
Configura acceso a red
Claude Code requiere acceso a:
- api.anthropic.com
- statsig.anthropic.com
- sentry.io
Lista blanca estas URLs cuando uses Claude Code en entornos containerizados.
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 soporta 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>
:
Clave | Valor | Descripción |
---|---|---|
autoUpdaterStatus | disabled o enabled | Habilitar o deshabilitar el auto-actualizador (por defecto: enabled ) |
preferredNotifChannel | iterm2 , iterm2_with_bell , terminal_bell , o notifications_disabled | Dónde quieres recibir notificaciones (por defecto: iterm2 ) |
theme | dark , light , light-daltonized , o dark-daltonized | Tema de color |
verbose | true o false | Si mostrar salidas completas de bash y comandos (por defecto: false ) |
Opciones de permisos del auto-actualizador
Cuando Claude Code detecta que no tiene suficientes permisos para escribir en tu directorio npm prefix 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 auto-actualizador, consulta la guía de solución de problemas.
Recomendado: Crear un nuevo npm prefix escribible por el usuario
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
Ya que Claude Code está en desarrollo activo, recomendamos configurar auto-actualizaciones usando la opción recomendada arriba.
Deshabilitar el auto-actualizador
Si prefieres deshabilitar el auto-actualizador en lugar de arreglar permisos, puedes usar:
Configuración de proyecto
Gestiona la configuración de proyecto con claude config set <clave> <valor>
(sin la bandera -g
):
Clave | Valor | Descripción |
---|---|---|
allowedTools | array de herramientas | Qué herramientas pueden ejecutarse sin aprobación manual |
ignorePatterns | array de strings glob | Qué archivos/directorios son ignorados al usar herramientas |
Por ejemplo:
Optimiza tu configuración de terminal
Claude Code funciona mejor cuando tu terminal está configurada apropiadamente. Sigue estas pautas para optimizar tu experiencia.
Shells soportados:
- 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 vía el comando /config
Saltos de línea
Tienes varias opciones para ingresar 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:
- Abre Configuración → Perfiles → Teclado
- Marca “Usar Option como tecla Meta”
Para iTerm2 y terminal VSCode:
- Abre Configuración → Perfiles → Teclas
- Bajo General, establece 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 sonoras cuando las tareas se completen:
Para usuarios de macOS: No olvides habilitar permisos de notificación en Configuración del Sistema → Notificaciones → [Tu App de Terminal].
Notificaciones del sistema iTerm 2
Para alertas de iTerm 2 cuando las tareas se completen:
- Abre Preferencias de iTerm 2
- Navega a Perfiles → Terminal
- Habilita “Silenciar campana” y “Enviar notificación cuando esté inactivo”
- 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 la Terminal por defecto de macOS.
Manejo de entradas grandes
Cuando trabajes con código extenso o instrucciones largas:
- Evita pegado directo: 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: La terminal de VS Code es particularmente propensa a truncar pegados largos
Al configurar estos ajustes, crearás un flujo de trabajo más suave y eficiente con Claude Code.
Gestiona costos efectivamente
Claude Code consume tokens por cada interacción. El uso típico cuesta entre $5-10 por desarrollador por día, pero puede exceder $100 por hora durante uso intensivo.
Rastrea tus costos
- Usa
/cost
para ver el uso de la sesión actual - Revisa el resumen de costos mostrado al salir
- Verifica el uso histórico en Anthropic Console
- Establece Límites de gasto
Reduce el uso de tokens
- Compacta conversaciones: Usa
/compact
cuando el contexto se vuelva grande - Escribe consultas específicas: Evita solicitudes vagas que activen escaneo innecesario
- Descompón tareas complejas: Divide tareas grandes en interacciones enfocadas
- Limpia historial entre tareas: Usa
/clear
para reiniciar contexto
Los costos pueden variar significativamente según:
- Tamaño de la base de código siendo analizada
- Complejidad de las consultas
- Número de archivos siendo buscados o modificados
- Longitud del historial de conversación
- Frecuencia de compactación de conversaciones
Para despliegues en equipo, recomendamos comenzar con un grupo piloto pequeño para establecer patrones de uso antes de un despliegue más amplio.
Uso con APIs de terceros
Claude Code requiere acceso tanto a los modelos Claude 3.7 Sonnet como Claude 3.5 Haiku, independientemente de qué proveedor de API uses.
Conectar a Amazon Bedrock
Si deseas anular el modelo por defecto, puedes pasar la variable de entorno ANTHROPIC_MODEL
(Claude 3.7 Sonnet se usa por defecto):
Si deseas acceder a Claude Code vía proxy, puedes usar la variable de entorno ANTHROPIC_BEDROCK_BASE_URL
:
Si no tienes habilitado el caché de prompts, también establece:
Requiere credenciales estándar del SDK de AWS (p.ej., ~/.aws/credentials
o variables de entorno relevantes como AWS_ACCESS_KEY_ID
, AWS_SECRET_ACCESS_KEY
). Para configurar credenciales AWS, ejecuta:
Contacta a Amazon Bedrock para caché de prompts para costos reducidos y límites de tasa más altos.
Los usuarios necesitarán acceso tanto a los modelos Claude 3.7 Sonnet como Claude 3.5 Haiku en su cuenta AWS. Si tienes un rol de acceso a modelos, puede que necesites solicitar acceso a estos modelos si no están ya disponibles.
Conectar a Google Vertex AI
Si deseas anular el modelo por defecto, puedes pasar la variable de entorno ANTHROPIC_MODEL
(Claude 3.7 Sonnet se usa por defecto):
Si deseas acceder a Claude Code vía proxy, puedes usar la variable de entorno ANTHROPIC_VERTEX_BASE_URL
:
Si no tienes habilitado el caché de prompts, también establece:
Claude Code en Vertex AI actualmente solo soporta la región us-east5
. Asegúrate
de que tu proyecto tenga cuota asignada en esta región específica.
Los usuarios necesitarán acceso tanto a los modelos Claude 3.7 Sonnet como Claude 3.5 Haiku en su proyecto de Vertex AI.
Requiere credenciales GCP estándar configuradas a través de google-auth-library. Para configurar credenciales GCP, ejecuta:
Para la mejor experiencia, contacta a Google para límites de tasa elevados.
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 solicitudes de permisos para operación desatendida. Hemos incluido una implementación de referencia que puedes personalizar para tus necesidades.
Si bien el devcontainer proporciona protecciones sustanciales, ningún sistema es completamente inmune a todos los ataques. Mantén siempre buenas prácticas de seguridad y monitorea las actividades de Claude.
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 restringiendo 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 y configuraciones preconfiguradas
- Persistencia de sesión: Preserva 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
- Instala VS Code y la extensión Remote - Containers
- Clona el repositorio de implementación de referencia de Claude Code
- Abre el repositorio en VS Code
- Cuando se te solicite, haz clic en “Reabrir en Contenedor” (o usa la Paleta de Comandos: Cmd+Shift+P → “Remote-Containers: Reabrir en Contenedor”)
Desglose de configuración
La configuración del devcontainer consiste en tres componentes principales:
- devcontainer.json: Controla configuraciones del contenedor, extensiones y montajes de volumen
- Dockerfile: Define la imagen del contenedor y 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 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 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 ser adaptable 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 red
- Personaliza configuraciones de shell y herramientas de desarrollo
Siguientes pasos
Tutoriales de Claude Code
Guías paso a paso para tareas comunes
Solución de problemas
Soluciones para problemas comunes con Claude Code
Implementación de referencia
Clona nuestra implementación de referencia de contenedor de desarrollo.
Licencia y uso de datos
Claude Code se proporciona como una vista previa Beta de investigación bajo los Términos de Servicio Comerciales de Anthropic.
Cómo usamos tus datos
Buscamos 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 por 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 (p.ej., 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, por favor 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.
Was this page helpful?