← Volver al listado de tecnologías ← Índice de Claude Code

Cap 1: Qué es Claude Code

2 de marzo de 2026 Por: Artiko

claude-codeclisetuparquitectura

Qué es Claude Code

Claude Code es la CLI oficial de Anthropic para desarrollo asistido por IA. Lee tu codebase, edita archivos, ejecuta comandos y se integra con tus herramientas. Está disponible en terminal, IDE (VS Code, JetBrains), desktop app y navegador.

Arquitectura Agentic

Claude Code opera con un loop agentic: recibe una instrucción, analiza el contexto, ejecuta herramientas (leer archivos, ejecutar comandos, editar código) y repite hasta completar la tarea.

flowchart LR
    U([Usuario]) --> P[Prompt]
    P --> A[Análisis]
    A --> T[Tool Use]
    T --> R[Resultado]
    R --> N[Siguiente acción]
    N --> RES([Respuesta])
    N -->|más pasos| A

Las herramientas internas principales son:

Herramienta	Función
`Read`	Leer archivos
`Edit`	Editar archivos (diffs)
`Write`	Crear archivos nuevos
`Bash`	Ejecutar comandos shell
`Glob`	Buscar archivos por patrón
`Grep`	Buscar contenido en archivos
`Agent`	Lanzar sub-agentes
`WebFetch`	Obtener contenido web
`WebSearch`	Buscar en la web

Instalación

# macOS, Linux, WSL (recomendado)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Iniciar en cualquier proyecto:

cd tu-proyecto
claude

La instalación nativa se auto-actualiza. Homebrew requiere brew upgrade claude-code manual.

Primer inicio y /init

Al ejecutar claude por primera vez en un proyecto, usa /init para generar un archivo CLAUDE.md con instrucciones del proyecto:

claude
> /init

Esto analiza tu codebase y crea un CLAUDE.md en la raíz con:

Comandos de desarrollo (build, test, lint)
Estructura del proyecto
Convenciones de código detectadas
Stack tecnológico

CLAUDE.md — Instrucciones persistentes

CLAUDE.md es el archivo más importante. Claude lo lee al inicio de cada sesión para entender tu proyecto.

Ubicaciones y jerarquía

Ubicación	Alcance	Compartible
`~/.claude/CLAUDE.md`	Global (todos los proyectos)	No
`./CLAUDE.md`	Proyecto (raíz del repo)	Sí (commiteable)
`./CLAUDE.local.md`	Proyecto (personal)	No (gitignored)
`src/CLAUDE.md`	Subdirectorio específico	Sí

Qué incluir

# CLAUDE.md

## Comandos de desarrollo
bun dev          # servidor de desarrollo
bun test         # ejecutar tests
bun build        # build de producción

## Convenciones
- TypeScript strict
- Arquitectura hexagonal
- Commits: feat: / fix: / refactor:

## Reglas
- No modificar archivos en /vendor
- Siempre ejecutar tests después de cambios

Mejores prácticas para CLAUDE.md

Máximo 150 líneas — Claude lo carga completo en contexto
Ser específico — comandos exactos, no instrucciones vagas
Actualizar regularmente — refleja el estado actual del proyecto
No duplicar — si algo está en la documentación estándar, no repetirlo

Superficies disponibles

Superficie	Características
Terminal	CLI completa, máximo control
VS Code	Diffs inline, @-mentions, historial
JetBrains	Plugin para IntelliJ, PyCharm, WebStorm
Desktop App	Revisión visual de diffs, sesiones paralelas
Web	Sin setup local, tareas de larga duración
iOS	Continuar sesiones desde el móvil

Modelos disponibles

Claude Code soporta diferentes modelos según la necesidad:

Alias	Modelo	Uso
`opus`	Claude Opus 4	Máxima capacidad, tareas complejas
`sonnet`	Claude Sonnet 4	Balance velocidad/capacidad
`haiku`	Claude Haiku 3.5	Rápido, tareas simples

Cambiar modelo en sesión:

claude --model sonnet
# o dentro de la sesión
/model sonnet

Siguiente: Commands