Cómo instalar y usar Claude Code en VS Code: guía completa

• Lo que vas a aprender: instalar Claude Code en VS Code y entrar con tu suscripción de Claude.
• Para quién es: para quien está empezando en vibe coding y quiere una IA que toque el proyecto de verdad.
• Resultado: un flujo simple para crear una funcionalidad, revisarla y publicarla.
• Requisito previo: una suscripción paga de Claude (Pro o Max) o una cuenta en Claude Console.

Claude Code es el asistente de programación de Anthropic. Le hablas en español y lee los archivos de tu proyecto, escribe el código y prueba el resultado.

La diferencia con el chat común es que no necesitas copiar y pegar nada. Trabaja directo en la carpeta del proyecto y solo revisas lo que cambió.

Lo que necesitas antes de empezar

• VS Code o Antigravity IDE instalado.
• Una suscripción paga de Claude, como Pro o Max. El plan gratuito de claude.ai no incluye Claude Code.
• Un proyecto, aunque sea solo una carpeta vacía para probar.

La forma más fácil: extensión y login con la suscripción

Paso 1. Instala la extensión

En VS Code, abre la pestaña de extensiones con Ctrl + Shift + X (o Cmd + Shift + X en Mac). Busca "Claude Code", de Anthropic, y haz clic en instalar.

Paso 2. Abre el panel de Claude

Abre cualquier archivo y haz clic en el ícono de Claude en la esquina superior derecha del editor. También puedes hacer clic en "Claude Code" en la barra inferior de la ventana.

Paso 3. Entra con tu cuenta

La primera vez aparece una pantalla de login. Haz clic en entrar, confirma en el navegador con la misma cuenta de tu suscripción y vuelve al editor.

Listo. No necesitas crear clave ni tocar configuración. Si algún día aparece el aviso "Not logged in", solo haz login de nuevo.

¿Prefieres la terminal? Usa la CLI

CLI es la versión de Claude Code que corre en terminal, esa pantalla de comandos de texto. En VS Code, abre la terminal con ` Ctrl + `` y ejecuta el instalador oficial:

$ curl -fsSL https://claude.ai/install.sh | bash

En Windows, usa el comando para PowerShell que está en la documentación oficial. Luego, dentro de la carpeta del proyecto, escribe:

$ claude

Abre el navegador para que entres con la suscripción. Para cambiar de cuenta después, escribe /login dentro de Claude Code.

Si tu editor no instala la extensión, la CLI resuelve: funciona en cualquier terminal, incluso en Antigravity IDE.

Alternativa: clave de API

Si no tienes suscripción, puedes usar una cuenta en Claude Console. Allí creas una clave de API, que es una contraseña para que programas accedan a Claude, y pagas por uso.

En la extensión o en el comando claude, elige entrar con la cuenta de Console. Guarda la clave fuera del proyecto y nunca la subas a GitHub.

Flujo práctico 1: crear una funcionalidad

Escribe el pedido como si hablaras con un colega. Por ejemplo:

Pedido: "Crea un formulario de contacto con nombre, email y mensaje. Valida los campos y muestra un mensaje de éxito. Antes de tocar nada, muéstrame el plan."

1. Claude muestra un plan con los archivos que va a crear o modificar.
2. Lo lees y apruebas, o pides ajustes al plan.
3. Escribe el código y ejecuta el proyecto para comprobar que funciona.

Pide una cosa a la vez. Los pedidos pequeños fallan menos y son más fáciles de revisar.

Flujo práctico 2: revisar el código

Antes de aceptar, mira lo que cambió. La extensión muestra los cambios lado a lado y la pestaña Source Control de VS Code lista cada línea modificada.

También puedes pedir una revisión al propio Claude:

Pedido: "Revisa lo que hiciste. Busca errores, campos sin validación y código repetido. Explícalo en lenguaje simple."

Si algo se rompe, pega el mensaje de error en el chat y pídele que lo corrija.

Flujo práctico 3: publicar con git y pull request

Git es el historial de versiones de tu proyecto. Un pull request, o PR, es una petición para unir tus cambios al proyecto principal después de una revisión.

1. Pide: "Crea una branch llamada formulario-contato y haz un commit con un mensaje claro."
2. Pide: "Envía la branch a GitHub." Si GitHub CLI está instalado, pide también abrir el PR.
3. Revisa el PR en GitHub y haz el merge.

Si el proyecto está conectado a un servicio de hospedaje que publica en cada merge, el sitio se actualiza solo.

Ese cuidado de revisar vale aún más cuando Anthropic cambia la API. Mira lo que cambió en la actualización de la Claude API del 21 de octubre y los ajustes en los SDKs.

El mismo flujo en bridgecode, con agentes en roles diferentes

Con un solo agente, haces todo en secuencia y acompañas cada paso. En bridgecode divides el trabajo entre agentes, cada uno con un rol:

• Planificador: lee el pedido y divide la funcionalidad en tareas pequeñas.
• Ejecutor: escribe el código de cada tarea.
• Revisor: verifica lo que se hizo y señala errores antes del PR.

Cada agente trabaja en una copia separada del proyecto, así que uno no interfiere con el otro y tu editor sigue libre. Apruebas el plan al inicio y el PR al final.

En empresas, vale la pena seguir los controles que Anthropic viene liberando, como los inference hooks de Claude Enterprise.