logongas

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.
====== Claude Code ======

[[https://code.claude.com|Claude Code]] es la herramienta de programación con IA de Anthropic. Como [[cursos:sdd:03-opencode|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 (la caja de entrada con ''@'', ''!'' y ''/'', una sesión por tarea, commitear a menudo) ya está en su tema.

----

===== 1. Puesta en marcha =====

==== Instalar ====

  * Linux
<sxh bash>
curl -fsSL https://claude.ai/install.sh | bash
claude --version
</sxh>

  * Windows (PowerShell)
<sxh powershell>
irm https://claude.ai/install.ps1 | iex
claude --version
</sxh>

==== Arrancar ====

<sxh bash>
cd mi-proyecto
claude
</sxh>

==== Actualizar ====

Se actualiza solo, en segundo plano. Para forzarlo:

<sxh bash>
claude update
</sxh>

----

===== 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.

<sxh plain>
/effort high
</sxh>

<note tip>Deja ''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.</note>

----

===== 3. Agentes y skills =====

Qué son está en [[cursos:sdd:02-skills-agentes-mcp|Skills, Agentes y MCP]]. Lo que cambia respecto a OpenCode es cómo se llaman:

  * **Skills con ''/''**: cada //skill// es un comando más. ''/revisar-pr'' ejecuta la //skill// ''revisar-pr''.
  * **Subagentes con ''@agent-''** y su nombre:
<sxh plain>
@agent-revisor-specs revisa specs/login/requirements.md
</sxh>

De serie trae tres subagentes: ''Explore'', que busca en el código sin modificar nada; ''Plan'', que investiga para el modo Plan; y ''general-purpose'', para tareas de varios pasos.

<note important>Aquí ''context: fork'' **sí funciona**: la //skill// se ejecuta en un subagente con el contexto limpio, sin ver tu conversación, y solo vuelve el resultado. Es lo que conviene para una revisión o una búsqueda larga que no quieres que llene tu contexto.</note>

----

===== 4. La caja de entrada =====

Funciona como en OpenCode (texto, ''@'', ''!'' y ''/''). Cambia el teclado:

  * **''\'' + ''Enter''**: salto de línea sin enviar. Funciona en cualquier terminal; ''Mayús+Enter'' solo en algunas.
  * **''Ctrl+R''**: busca entre los prompts que ya has mandado.
  * **''Ctrl+G''**: abre el prompt en tu editor, para escribir uno largo con comodidad.
  * **''Ctrl+V''**: pega una imagen del portapapeles, por ejemplo una captura de un error o el boceto de una pantalla.

----

===== 5. Los modos: la tecla Mayús+Tab =====

En lugar de dos modos con ''Tab'', Claude Code tiene varios y se recorren con **''Mayús+Tab''**. La diferencia está en **qué te pregunta antes de hacerlo**:

^ Modo ^ Toca el disco ^ Qué te pregunta ^
| **Manual** | ✓ | Todo: cada edición y cada comando |
| **Aceptar ediciones** | ✓ | Solo los comandos; los ficheros los edita sin preguntar |
| **Plan** | | Nada: lee, analiza y propone, como el Plan de OpenCode |
| **Auto** | ✓ | Nada: un segundo modelo revisa cada acción y para solo las peligrosas |

El ciclo de un cambio es el mismo que en OpenCode: **Plan** hasta que el plan está bien y, al aceptarlo, Claude Code ofrece pasar directamente a ejecutar.

<note warning>**Auto** es cómodo, pero quien decide lo que se ejecuta ya no eres tú. Úsalo solo en un repositorio con todo commiteado, para poder volver atrás.</note>

Lo que permitas «siempre» en el diálogo de permisos queda guardado como regla del proyecto. ''/permissions'' las enseña y permite borrarlas.

==== Mientras trabaja ====

  * **''Esc''** (una sola vez) lo interrumpe y conserva lo que ya ha hecho.
  * Los mensajes que escribas mientras trabaja se encolan, igual que en OpenCode.
  * **''/btw''** hace una pregunta al margen, sin interrumpirlo y sin que quede en la conversación:
<sxh plain>
/btw ¿qué diferencia hay entre @Mock y @MockBean?
</sxh>
  * **''Ctrl+B''** manda a segundo plano un comando largo (unos tests, un ''build'') y puedes seguir hablando con él mientras termina.

==== Volver atrás: Esc Esc ====

''Esc Esc'' con la caja vacía (o ''/rewind'') abre la lista de tus prompts. Eliges hasta cuál volver y qué se restaura:

  * **Código y conversación**: como si no hubiera pasado nada desde ese prompt.
  * **Solo la conversación**: te quedas con los cambios en los ficheros pero se olvida lo hablado.
  * **Solo el código**: deshace los cambios en los ficheros y la conversación sigue.

<note important>Solo deshace lo que Claude Code **editó con sus herramientas**. Lo que hizo con un comando de shell (un ''rm'', un ''mv'', un ''git checkout'') no se recupera. El deshacer de verdad sigue siendo ''git''.</note>

----

===== 6. AGENTS.md y el CLAUDE.md que crea /init =====

Claude Code lee ''AGENTS.md'' él solo, igual que OpenCode. La trampa está en ''/init'': **genera un ''CLAUDE.md''**, no un ''AGENTS.md''. Y si existe un ''CLAUDE.md'', Claude Code deja de leer el ''AGENTS.md'' ([[cursos:sdd:02-skills-agentes-mcp#claudemdno_usarlo|por qué no usarlo]]).

Así que, tras ''/init'', se renombra:

<sxh bash>
git mv CLAUDE.md AGENTS.md
</sxh>

Si ya tenías ''AGENTS.md'', lo que interese del ''CLAUDE.md'' generado se pasa a mano al ''AGENTS.md'' y el ''CLAUDE.md'' se borra.

----

===== 7. La sesión y el contexto =====

Lo de OpenCode vale igual (una sesión por tarea, ''/compact'' cuando el contexto va alto). Cambian los comandos:

^ Comando ^ Cuándo ^
| ''/context'' | Ver **en qué** se va el contexto: instrucciones del sistema, ''AGENTS.md'', //skills//, MCP y la conversación. Es lo que hay que mirar si el contexto se llena sin motivo |
| ''/compact'' | Como en OpenCode, pero se le puede decir qué conservar: ''/compact conserva las decisiones de diseño del login'' |
| ''/clear'' | El ''/new'' de OpenCode: contexto a cero |
| ''/resume'' | Elegir una sesión anterior y seguir con ella |

Desde la terminal se retoma directamente:

  * La última sesión de esta carpeta:
<sxh bash>
claude -c
</sxh>

  * Una concreta, eligiéndola de la lista:
<sxh bash>
claude -r
</sxh>

Cuando el contexto está a punto de llenarse, Claude Code compacta solo. No esperes a eso: el resumen automático no sabe qué es lo importante para ti.

----

===== 8. Integración con VS Code =====

<sxh bash>
code --install-extension anthropic.claude-code
</sxh>

A diferencia de la de OpenCode, no es la terminal dentro del editor: es un **panel gráfico** propio, con los cambios en forma de //diff// que se aceptan o rechazan y varias conversaciones en pestañas.

El atajo para mandarle código es **''Alt+K''** (no ''Ctrl+Alt+K''): añade al prompt la referencia a la selección, por ejemplo ''@Login.java#5-10'', o al fichero entero si no hay nada seleccionado.

----

===== 9. 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:
<sxh plain>
/plugin
</sxh>

  * Añadir un //marketplace// a partir de su repositorio de GitHub:
<sxh plain>
/plugin marketplace add jarrodwatts/claude-hud
</sxh>

  * Instalar un plugin. Va con ''@'' y el //marketplace// del que sale:
<sxh plain>
/plugin install claude-hud@claude-hud
</sxh>

----

===== 10. 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''. [[https://github.com/jarrodwatts/claude-hud|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.

Se instala como en la sección anterior y se activa con:

<sxh plain>
/claude-hud:setup
</sxh>

----

===== 11. Chuleta =====

Solo lo que cambia respecto a la [[cursos:sdd:03-opencode#chuleta|de OpenCode]]:

^ ^ ^
| ''claude'' | Arrancar en la carpeta actual |
| ''claude -c'' | Seguir con la última sesión |
| ''/login'' | Entrar con tu cuenta |
| ''/model'' | Cambiar de modelo (''opusplan'': Opus para planificar, Sonnet para ejecutar) |
| ''/effort'' | Cuánto razona |
| ''Mayús+Tab'' | Cambiar de modo: Manual, Aceptar ediciones, Plan, Auto |
| ''Esc'' | Parar al agente |
| ''Esc Esc'' | Volver atrás (''/rewind'') |
| ''\'' + ''Enter'' | Salto de línea |
| ''/skill'' / ''@agent-nombre'' | Ejecutar una //skill// o un subagente |
| ''/btw'' | Pregunta al margen |
| ''Ctrl+B'' | Mandar un comando a segundo plano |
| ''/context'' | En qué se va el contexto |
| ''/clear'' | Sesión nueva |
| ''/usage'' | Cuánto queda del límite del plan |
| ''/plugin'' | Gestor de plugins |

----

===== 12. Enlaces =====

  * [[https://code.claude.com|code.claude.com]]
  * [[https://code.claude.com/docs/es/overview|Documentación]]
  * [[https://code.claude.com/docs/en/interactive-mode|Atajos de teclado y modo interactivo]]: la lista completa