Cómo usar Claude Code: guía de la primera semana con instalación, planes, permisos y skills

Qué es Claude Code y dónde se ejecuta en 2026

La mayoría de quienes buscan cómo usar claude code ya han usado un chatbot y quieren saber qué cambia cuando la IA puede tocar sus archivos. La documentación de Anthropic describe Claude Code como una herramienta de programación con agente que lee tu código, edita archivos y ejecuta comandos. Su página sobre cómo funciona nombra tres fases, reunir contexto, actuar y verificar resultados, que se repiten hasta terminar la tarea. Puedes interrumpir el ciclo en cualquier momento.

La página de presentación enumera dónde se ejecuta: la terminal, VS Code y los IDE de JetBrains, una app de escritorio y la web en claude.ai/code, y todos comparten los archivos CLAUDE.md y los ajustes del proyecto. La guía de terminal de Anthropic dice que puedes usar Claude Code aunque nunca hayas usado una terminal. No hace falta saber programar para instalarlo, pero de ello depende cuánto del trabajo podrás juzgar.

Instalar Claude Code, iniciar sesión y cuánto cuesta

La página de configuración avanzada de Anthropic enumera los requisitos actuales: macOS 13.0 o posterior, Windows 10 1809 o posterior, Ubuntu 20.04 o Debian 10 o posterior, 4 GB de RAM, conexión a internet y uno de los países donde Anthropic ofrece el servicio. El instalador nativo recomendado es una línea que se copia del inicio rápido. Después abre una terminal nueva y escribe claude --version para ver un número de versión. Las instalaciones nativas se actualizan solas, mientras que las de Homebrew y WinGet hay que actualizarlas a mano.

La primera vez que escribes claude en la carpeta de un proyecto, te pide iniciar sesión desde el navegador. El inicio rápido admite una suscripción Claude Pro, Max, Team o Enterprise, una cuenta de Claude Console con créditos de API prepagados o un proveedor de nube como Amazon Bedrock. Las credenciales quedan guardadas tras ese primer acceso. Más adelante, /login dentro de una sesión permite cambiar de cuenta.

¿Se puede probar gratis? La página de precios de Anthropic dice que el plan gratuito no incluye Claude Code y que todos los planes de pago sí. Con una suscripción, el trabajo en la terminal y los chats comparten un único fondo, con límites en una ventana móvil de cinco horas y límites semanales. El comando /usage muestra lo que han consumido tus sesiones.

Terminal, VS Code o app de escritorio como punto de partida

La terminal es la versión completa. La página de Anthropic sobre VS Code señala como exclusivos de la línea de comandos el conjunto completo de comandos y skills, el autocompletado con tabulador y el atajo del signo de exclamación para el shell. La extensión de VS Code, que requiere la versión 1.94.0 o posterior, ofrece un subconjunto de comandos, pero añade un panel gráfico con diffs en línea y planes que puedes editar antes de aceptarlos. Es el comienzo más amable para quien ya edita código ahí.

Hay una pega: la extensión incluye una copia privada de Claude Code, así que no añade claude a tu PATH. Para ejecutar claude en la terminal integrada sigues necesitando la instalación independiente. Si el obstáculo es la propia terminal, la presentación describe una app de escritorio que incluye Claude Code y exige una suscripción de pago.

Una primera sesión de Claude Code en un proyecto real y pequeño

Elige un proyecto pequeño que puedas permitirte romper, como una web personal. Ponlo bajo git y haz un commit antes de nada. La guía de buenas prácticas de Anthropic dice que los puntos de control solo registran las ediciones hechas con las herramientas de archivos de Claude, no con comandos de shell, y que no sustituyen a git. Luego abre una terminal ahí, escribe claude y responde al diálogo de confianza en el espacio de trabajo que describe la página de seguridad.

Empieza con preguntas. El inicio rápido sugiere preguntar qué hace el proyecto, qué tecnologías usa y dónde está el punto de entrada principal, y Claude lee por su cuenta los archivos que necesita. Después pide un cambio pequeño con resultado visible, por ejemplo un pie de página con el año actual. Lee el diff, pregunta qué archivos cambiaron y deja que haga el commit con un mensaje descriptivo. Pregunta, cambio, revisión, commit: ese es todo el primer día.

Cómo encargar una tarea a Claude Code: contexto, plan y comprobación

La guía de buenas prácticas basa la mayoría de sus consejos en una limitación: la ventana de contexto se llena rápido y el rendimiento baja a medida que se llena. Por eso conviene una sola tarea por conversación, usar /clear entre tareas sin relación y ser concreto. La guía convierte el encargo de arreglar el error de inicio de sesión en uno que nombra el síntoma, la carpeta probable y una prueba que debe fallar primero.

El segundo hábito es un plan antes del código. La guía recomienda cuatro fases: explorar, planificar, implementar y hacer commit. En el modo plan, al que se entra con Shift+Tab o con un mensaje que empiece por /plan, Claude lee y propone, pero no edita tu código fuente hasta que apruebas. Si podrías describir el diff en una frase, dice la guía, sáltate el plan.

El tercer hábito es una comprobación que el agente pueda ejecutar. Sin una prueba, una compilación o una captura con la que comparar, advierte la guía, tú pasas a ser el bucle de verificación. Pídele que muestre la salida de las pruebas en vez de afirmar que todo funciona. Pulsa Esc para detener una ejecución que se desvía, o Esc dos veces para volver a un estado anterior, y tras dos correcciones fallidas limpia la sesión y escribe un mejor encargo.

Modos de permisos de Claude Code y los hábitos de seguridad que los acompañan

Un modo de permisos decide qué puede hacer Claude sin preguntar. La página de modos de permisos de Anthropic enumera seis. El modo manual, cuyo valor de configuración es default, solo ejecuta lecturas sin preguntar, mientras que acceptEdits deja pasar también las ediciones de archivos. El modo plan lee y propone. El modo automático entrega las aprobaciones a un modelo clasificador, y bypassPermissions omite las comprobaciones, solo para contenedores y máquinas virtuales aislados.

Con Claude Code v2.1.283 o posterior, dice esa misma página, el modo automático es el modo inicial de las sesiones interactivas de terminal y VS Code. Su clasificador bloquea por defecto acciones de riesgo, como código canalizado desde curl, force push y despliegues a producción. La página advierte además que el modo automático no garantiza la seguridad. En tu primera semana, pulsa Shift+Tab hasta que la barra de estado muestre el modo manual y aprueba cada comando tú mismo.

La página de seguridad de Anthropic te hace responsable de revisar el código y los comandos antes de aprobarlos. Deja los secretos fuera del chat y bloquea archivos como .env con una regla de denegación de lectura, pues la página de permisos aclara que un archivo .claudeignore no tiene efecto. Trata los repositorios descargados como no fiables, porque la inyección de instrucciones, texto escrito para dirigir a un asistente de IA, puede esconderse en un README. Si el código de un cliente o empleador puede subirse a una herramienta de IA en la nube depende de tu contrato y de la ley local de protección de datos, que varía según el país.

CLAUDE.md, comandos con barra, skills, subagentes y hooks

CLAUDE.md es un archivo markdown en la raíz de tu proyecto que Claude Code lee al comienzo de cada sesión. La página de memoria de Anthropic sugiere poner ahí lo que si no tendrías que repetir, como los comandos de compilación y las convenciones. Con /init se genera un borrador a partir de tu código. Mantenlo por debajo de 200 líneas y con reglas lo bastante concretas para comprobarlas, porque la página lo llama contexto, no configuración obligatoria.

Una skill es una carpeta con un archivo SKILL.md: una descripción de cuándo usarla y luego las instrucciones. Claude la carga cuando la descripción encaja, o tú escribes una barra y su nombre. Para añadir skills a Claude Code, guarda la carpeta en ~/.claude/skills para todos los proyectos o en .claude/skills dentro de un repositorio. La documentación de Agent Skills de Anthropic dice que al inicio solo se cargan el nombre y la descripción, unos 100 tokens por skill. El repositorio anthropics/skills de GitHub se instala como un marketplace de plugins, y su README llama a esas skills demostraciones que conviene probar antes.

La misma documentación indica usar solo skills de fuentes de confianza y auditar todos los archivos de cualquier otra, ya que una skill puede ordenar a Claude que ejecute código. Los subagentes trabajan en su propia ventana de contexto y devuelven solo un resumen. Los hooks son scripts que se ejecutan en momentos fijos, como un formateador tras cada edición, y a diferencia de CLAUDE.md se ejecutan siempre.

Practicar Claude Code esta semana, por tu cuenta o con un curso

Una semana basta para lo esencial si cada día termina con una tarea acabada. El primer día, instala la herramienta, confía en una carpeta y haz solo preguntas. El segundo, haz tres cambios pequeños, cada uno revisado y con su commit. El tercero, redacta un CLAUDE.md con /init y recórtalo, y el cuarto, haz una tarea en modo plan con una prueba que deba pasar. El quinto, escribe una skill propia tras leer los SKILL.md de dos publicadas.

Para esa lectura, el catálogo de skills de agentes de VITON13 SCHOOL es gratuito: 71 skills recopiladas de GitHub en 11 estanterías, desde programación hasta seguridad y flujo de trabajo de agentes, cada una con su número de estrellas, el comando de instalación y una guía breve, actualizado el 24 de octubre de 2026. El número de estrellas es una instantánea de popularidad, no una valoración. Practicar por tu cuenta enseña cómo usar claude code a diario. Es más difícil aprender solo dónde un agente se gana su lugar y dónde hace daño.

Un curso estructurado añade lo que falta. El curso de Inteligencia Artificial de VITON13 SCHOOL tiene siete módulos, desde trabajar con IA de forma deliberada y el prompting como ingeniería hasta los agentes de IA, los sistemas propios y la seguridad y responsabilidad. El módulo de agentes cubre herramientas, memoria, pasos, control y condiciones de parada. Entre sus resultados figuran una biblioteca personal de prompts con versiones y criterios de aceptación y un agente funcional para una tarea real del estudiante.