Tabla de Contenidos
¡Esta es una revisión vieja del documento!
Claude Code
Claude Code es la herramienta de programación con IA de Anthropic. Como OpenCode, vive dentro de la terminal y trabaja sobre los ficheros de la carpeta en la que se lanza. Aquí solo se cuenta lo que no tiene OpenCode o se hace de otra forma; lo que funciona igual ya está en su tema.
1. Puesta en marcha
Instalar
- Linux
curl -fsSL https://claude.ai/install.sh | bash claude --version
- Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex claude --version
Arrancar
cd mi-proyecto claude
Actualizar
Se actualiza solo, en segundo plano. Para forzarlo:
claude update
2. Cuenta y modelos
Es la gran diferencia con OpenCode: solo habla con modelos de Anthropic y no hay nada gratis. No existe /connect ni modelos free.
/login: entra con tu cuenta. Vale una suscripción Pro o Max de Claude (pago fijo al mes, con un límite de uso que se renueva cada pocas horas) o una cuenta de la API (pago por token). El plan gratuito de Claude no incluye Claude Code./usage: cuánto llevas gastado del límite de tu plan y cuándo se renueva.
/model: cambiar de modelo
Abre la lista de modelos. Enter lo deja como predeterminado y s lo cambia solo para esta sesión.
| Modelo | Cuándo |
|---|---|
opus | El más capaz. Para planificar y para lo difícil |
sonnet | Más barato y rápido. Para implementar lo ya decidido |
haiku | El más barato. Tareas mecánicas |
opusplan | Opus en modo Plan y Sonnet al ejecutar, sin tener que cambiar a mano |
opusplan hace solo el flujo que en OpenCode se hace a mano con /models: el modelo caro donde se decide y el barato donde solo se ejecuta.
/effort: cuánto piensa
Además del modelo se elige cuánto razona antes de responder: /effort low, medium, high, xhigh o max. Más esfuerzo es mejor respuesta, pero más lenta y más cara.
/effort high
medium para el día a día y sube a high o xhigh para el diseño o para un fallo que no hay manera de encontrar.
3. Agentes
Qué es un subagente y para qué sirve está en el tema 2. De serie, Claude Code trae dos:
general-purpose: para tareas de varios pasos que investigan y cambian código.explore: busca y entiende el código sin modificar nada.
Cómo se lanza
Hay tres formas de lanzarlo:
- Invocándolo directamente con
@agent-y su nombre. Al escribir@sale en la lista junto a los ficheros.
@agent-explore ¿dónde se valida el token JWT y qué endpoints no pasan por esa validación?
- Con lenguaje natural, diciéndole que lo use:
Usa el subagente general-purpose para migrar los tests del módulo pedidos de JUnit 4 a JUnit 5
- Automáticamente: lo decide Claude Code, que lo lanza cuando la tarea encaja con su
description. Es lo que pasa casi siempre: le preguntas algo sobre el código y verás que lanzaexploresin que se lo pidas.
Los subagentes van en segundo plano: sigues hablando con Claude mientras trabajan. Si uno se queda en primer plano bloqueando la sesión, Ctrl+B lo manda a segundo plano.
Dónde se guardan
Cada subagente es un fichero .md:
.claude/agents/en el proyecto: está en el repositorio para que sea solo de ese proyecto.~/.claude/agents/en tu ordenador: para compartirlo entre proyectos
4. Skills
Qué es una skill y cómo se escribe está en el tema 2.
Cómo se lanza
Hay tres formas de lanzarla:
- Invocándola directamente con
/y su nombre: cada skill es un comando más, y al escribir/sale en la lista. Lo que escribas detrás le llega como argumento.
/revisar-pr 128
- Con lenguaje natural, diciéndole que la use:
Usa la skill revisar-pr con el PR 128
- Automáticamente: lo decide Claude Code, que la carga cuando su
descriptionencaja con lo que pides («revisa el PR 128»).
Dónde se guardan
Cada skill es una carpeta con su SKILL.md:
.claude/skills/en el proyecto: está en el repositorio para que sea solo de ese proyecto.~/.claude/skills/en tu ordenador: para compartirla entre proyectos.
5. Modos: Plan y Build
Como en OpenCode, hay dos modos: Plan y Build, y se cambia entre ellos con Mayús+Tab.
El modo Plan
Lee, analiza y te propone un plan, sin editar ningún fichero, como el Plan de OpenCode. Puede ejecutar los comandos simples que necesite para investigar, pero antes los revisa el clasificador. Cualquier otro comando te lo pregunta.
El clasificador es una IA de Claude que decide qué tiene que preguntarte y qué no.
Cuando el plan está bien y lo aceptas, Claude Code ofrece pasar directamente a Build para ejecutarlo.
El modo Build
Ejecuta: edita ficheros y lanza comandos. Es un único modo, pero hay tres tipos según los permisos, es decir, según qué te pregunta antes de hacer algo:
| Tipo | Editar en la carpeta | Comandos simples (mkdir, mv, cp, rm…) | Todo el resto |
|---|---|---|---|
| Manual | Pregunta | Pregunta | Pregunta |
| Aceptar ediciones | ✓ | ✓ | Pregunta |
| Auto | ✓ | ✓ | ✓ El clasificador revisa cada acción: bloquea lo peligroso y sigue |
Mayús+Tab recorre los tres tipos de Build y el Plan en este orden: Manual, Aceptar ediciones, Plan y Auto.
Debajo de la caja de entrada se ve siempre en qué modo estás, con la coletilla «mode on»: plan mode on, auto mode on… En Manual no aparece nada.
6. Comandos
/init
Genera las instrucciones fijas del proyecto: analiza el código y escribe qué es el proyecto, su arquitectura y los comandos habituales (arrancar, probar, construir). Es un punto de partida: revísalo y edítalo a mano.
La trampa: genera un CLAUDE.md, no un AGENTS.md, y si existe un CLAUDE.md Claude Code deja de leer el AGENTS.md (por qué no usarlo). Así que se renombra; si ya tenías AGENTS.md, se pasa a él lo que interese y el CLAUDE.md se borra.
git mv CLAUDE.md AGENTS.md
/clear
Empieza de cero: borra la conversación y deja el contexto vacío. Se hace cada vez que cambias de tarea.
/rewind
Vuelve atrás: abre la lista de tus prompts, eliges hasta cuál volver y qué se restaura: el código, la conversación o los dos.
rm, un mv, un git checkout) no se recupera. El deshacer de verdad sigue siendo git.
/compact
Resume la conversación para liberar contexto y seguir en la misma sesión.
/compact: antes de llegar a él, usa /clear. El resumen lo hace el modelo, que no sabe qué es lo importante para ti, y sigues trabajando con un contexto peor sin darte cuenta.
ESC
No es un comando, es una tecla: pulsada una vez, para al agente en seco, esté pensando o a media tarea. Lo que ya ha hecho se queda hecho: le dices qué cambiar y sigue.
ESC ESC no interrumpe, abre /rewind.
7. Plugins
Un plugin de Claude Code es un paquete que puede traer skills, subagentes, hooks y servidores MCP a la vez. No se instalan desde npm sino desde marketplaces: repositorios de GitHub con un catálogo de plugins. El oficial de Anthropic, claude-plugins-official, ya viene añadido.
- Abrir el gestor de plugins, para ver los instalados y buscar en los catálogos:
/plugin
- Añadir un marketplace a partir de su repositorio de GitHub:
/plugin marketplace add jarrodwatts/claude-hud
- Instalar un plugin. Va con
@y el marketplace del que sale:
/plugin install claude-hud@claude-hud
8. Plugins a instalar
claude-hud: contexto y límites siempre a la vista
Claude Code no enseña en pantalla el contexto ocupado ni cuánto queda del límite del plan: hay que pedirlo con /context y /usage. claude-hud lo pone en la barra de estado, debajo de la caja de entrada: modelo, porcentaje de contexto, uso del plan, la herramienta o el subagente que se está ejecutando y las tareas pendientes. No ocupa contexto.
Sin el plugin, debajo de la caja de entrada solo se ve el modo:
Con el plugin, en la misma sesión aparece debajo una barra de estado con varias líneas:
Vamos a ver qué es cada cosa:
- Modelo: con el que estás trabajando (
Sonnet 5.5). - Proyecto: la carpeta en la que se ha arrancado Claude Code (
tienda). - Directorio añadido: otra carpeta a la que también tiene acceso (
+disenyo-interfaces). - Rama de git: la rama actual; el
*indica que hay cambios sin commitear. - Duración de la sesión: cuánto tiempo lleva abierta (
1m). - Contexto ocupado: cuánto de la ventana de contexto se ha gastado (4 %). Es lo que dice cuándo hacer
/clear. - Uso del plan: cuánto llevas gastado del límite de tu suscripción (3 %) y cuándo se renueva (en 2 h 12 min).
- MCP y hooks cargados: cuántos servidores MCP y hooks están activos.
- Herramientas que ha usado: las que ha usado en la última petición y cuántas veces (
Read ×1). Mientras trabaja se ve la que está ejecutando, y también los subagentes y las tareas pendientes. - Modo: este no es del plugin, sale también sin él.
Se instala como en la sección anterior y se activa con:
/claude-hud:setup
Por defecto solo enseña el modelo, el proyecto, la rama de git, el contexto y el uso del plan. El resto de lo que sale en las capturas (la duración, los MCP y hooks, las herramientas, los subagentes y las tareas) hay que activarlo con:
/claude-hud:configure
Te pregunta qué quieres ver y lo guarda en ~/.claude/plugins/claude-hud/config.json. Esta es la configuración de las capturas; las líneas a true de display son lo que se ve:
{
"lineLayout": "expanded",
"showSeparators": false,
"gitStatus": {
"enabled": true,
"showDirty": true,
"showAheadBehind": false,
"showFileStats": false
},
"display": {
"showModel": true,
"showContextBar": true,
"showTools": true,
"showAgents": true,
"showTodos": true,
"showProject": true,
"showConfigCounts": true,
"showTokenBreakdown": false,
"showSpeed": false,
"showUsage": true,
"usageBarEnabled": true,
"showSessionName": true,
"showDuration": true,
"customLine": ""
}
}
9. Enlaces
- Atajos de teclado y modo interactivo: la lista completa



