Cómo usar Claude Code: instalación y primer proyecto

Para usar Claude Code instálalo con el comando de tu sistema (en Mac y Linux, curl -fsSL https://claude.ai/install.sh | bash), abre una terminal en la carpeta de tu proyecto, escribe claude e inicia sesión con una cuenta de pago o de API. Luego pídele que explique el proyecto, genera un archivo CLAUDE.md con /init y revisa cada cambio.

Vigente al 11 de noviembre de 2026.

Claude Code es un agente de programación que se usa conversando, en la carpeta de tu proyecto: describes la tarea, el agente lee archivos, propone o aplica cambios y tú los revisas.

Para entender qué es primero, mira qué es Claude Code y para qué sirve. Aquí van los pasos, con datos de la documentación de Anthropic abierta el 11 de noviembre de 2026. Claude Code es marca de Anthropic. JustSEO no está afiliada ni patrocinada por ella.

¿Qué necesitas antes de instalar Claude Code?

Una terminal abierta, un proyecto y una cuenta: una suscripción de Claude (Pro, Max, Ultra, Team o Enterprise), una cuenta de Claude Console con acceso por API, o un proveedor de nube compatible (inicio rápido). El plan gratis de Claude no incluye Claude Code; los montos están en cuánto cuesta Claude Code al mes. Si nunca has usado una terminal, hay una guía para abrirla y pegar comandos.

¿Cómo se instala Claude Code?

Pega en la terminal el comando de tu sistema (inicio rápido, 11 de noviembre de 2026):

La instalación nativa se actualiza sola; Homebrew y WinGet no (brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode). El instalador no muestra avance mientras descarga. Al terminar, abre una terminal nueva y escribe:

claude --version

Si imprime un número de versión, quedó listo. Si dice que claude no existe, falta agregar la carpeta de instalación al PATH: Anthropic lo explica en su guía de problemas de instalación. En Windows nativo recomienda tener Git for Windows; sin él, Claude Code usa PowerShell. PowerShell muestra PS C:\ en el prompt y CMD no.

También existen la extensión de VS Code, el complemento de JetBrains, la aplicación de escritorio y la versión web (todas las opciones).

¿Cómo inicias tu primera sesión?

Entra a la carpeta del proyecto y escribe claude:

cd ruta/a/tu-proyecto
claude

La primera vez te pide iniciar sesión y abre el navegador. Después queda guardado. Con ANTHROPIC_API_KEY configurada, te pregunta si quieres usar esa clave y, si aceptas, se salta el inicio de sesión: eso significa cobro por consumo, no tu suscripción. Dentro de la sesión, /help muestra los comandos, /resume retoma una conversación y /login cambia de cuenta.

¿Qué le pides primero a Claude Code?

Que entienda tu proyecto antes de pedirle cambios. El inicio rápido sugiere:

what does this project do?

El agente lee los archivos que necesita sin que se los pases a mano. Otras preguntas útiles: qué tecnologías usa, dónde está el punto de entrada, cómo se organizan las carpetas.

¿Cómo preparas tu proyecto con CLAUDE.md?

Con un archivo CLAUDE.md en la raíz, que Claude Code lee al empezar cada sesión. Escribe lo que no puede deducir del código: comandos para correr pruebas, convenciones, decisiones del equipo (memoria).

El comando /init analiza el proyecto y genera uno inicial; si ya existe, sugiere mejoras. Anthropic aconseja mantenerlo bajo 200 líneas (costos). Las preferencias solo tuyas van en CLAUDE.local.md, que agregas a .gitignore. Nunca pongas claves en estos archivos.

Lo hacemos contigo en JustSEOSi tu equipo de desarrollo quiere partir con Claude Code y buenas reglas desde el primer día, agenda un diagnóstico de IA gratis de 30 minutos.El diagnóstico inicial no tiene costo.Ver la capacitación en IA

¿Cómo usar Claude Code en tu primer cambio sin riesgo?

Con un cambio pequeño, un modo de permiso que pregunte y git:

1. Crea una rama. Pídele "crea una rama llamada prueba-claude". Así el cambio queda aislado.

2. Pide el cambio con detalle. Nombra el archivo, el síntoma y cómo se ve "arreglado". La documentación contrasta "arregla el bug del login" con un pedido que explica el síntoma, dónde mirar y qué prueba escribir primero (mejores prácticas).

3. Elige el modo de permiso. Con Shift+Tab cambias de modo. En el manual, Claude Code pregunta antes de la mayoría de las acciones que editan archivos o ejecutan comandos; el de plan explora antes de cambiar nada. Desde la versión 2.1.283, el modo inicial en terminal y VS Code es el automático, donde un clasificador revisa las acciones en vez de ti (modos de permiso). Si quieres aprobar cada paso, cámbialo a manual.

4. Dale una forma de verificar. Pídele que corra tus pruebas o tu lint. Según Anthropic, cuando Claude dice que terminó y no era así, suele ser porque no tenía cómo comprobar su trabajo.

5. Revisa y confirma. Pregunta "¿qué archivos cambié?", lee el diff y, si te convence, pídele "haz commit con un mensaje descriptivo".

Cuando cambies de tema, usa /clear: el contexto viejo gasta tokens y distrae.

¿Qué comandos conviene saber?

Los que el inicio rápido lista como esenciales (11 de noviembre de 2026):

Desde la práctica

En JustSEO usamos Claude Code todos los días, con skills propias para el blog, la prospección y la edición de video, subagentes en paralelo y conectores MCP. En el blog, un validador por script revisa cada artículo, una segunda lectura coteja hechos y Yamil Alfonzo revisa y firma. Cómo se empaquetan estos procedimientos: qué es una skill en agentes de IA.

¿Cómo partir en una pyme?

Con una tarea acotada: corregir un detalle de la web, escribir una prueba, entender un código heredado. Elige un proyecto con git y alguien que pueda leer el cambio antes de publicarlo. Para ver el mapa completo de herramientas, mira la guía para programar con IA y el directorio de herramientas de IA. Para practicar con tareas propias, tenemos capacitación en IA.

Redactado con apoyo de IA y revisado por una persona. Cómo escribimos.