Setup inicial para vibe coding: preparando VS Code con Codex

Bienvenido al vibe coding.

Antes de pedir que un agente escriba, refactorice o revise código, prepara el ambiente.

Sin eso, aumentas el ruido. Pierdes historial. Mezclas herramientas. Dejas decisiones importantes escondidas en ventanas sueltas de chat.

Esta guía cubre el setup inicial para trabajar con VS Code, Codex y GitHub en Windows o macOS.

1. Entiende el acceso a Codex

Codex es el agente de programación de OpenAI. Puede actuar desde la aplicación, la CLI, la extensión de IDE y la web.

La forma más directa de empezar es entrar al cliente Codex con tu cuenta de ChatGPT. El uso está disponible en planes elegibles de ChatGPT, con límites que varían por plan.

También existe uso por API para flujos técnicos específicos, automatizaciones y organizaciones que prefieren provisionar claves manualmente.

Antes de configurar, consulta la documentación actual:

• OpenAI para desarrolladores
• Plataforma de desarrolladores de OpenAI

Si eliges usar una API key:

1. Accede a la plataforma de desarrolladores de OpenAI.
2. Crea una cuenta o inicia sesión.
3. Configura la facturación en Settings > Billing.
4. Crea una clave en API Keys.
5. Guarda la clave en un lugar seguro. No debe ser commiteada en el repositorio.

2. Instala VS Code

Visual Studio Code será la base de trabajo.

Puedes descargarlo desde el sitio oficial o instalarlo por terminal.

En Windows, usando PowerShell:

winget install -e --id Microsoft.VisualStudioCode

En macOS, usando Homebrew:

brew install --cask visual-studio-code

Después de instalar, abre VS Code y confirma que el terminal integrado funciona.

3. Reduce conflicto entre asistentes

Si ya usas GitHub Copilot u otro asistente, decide qué herramienta va a dirigir la sesión.

Para vibe coding, lo ideal es evitar dos agentes compitiendo por el mismo espacio. Autocomplete agresivo, atajos duplicados y sugerencias constantes pueden dificultar la lectura de lo que el agente principal está haciendo.

No necesitas eliminar todo para siempre. Pero durante una sesión con Codex, vale pausar o deshabilitar extensiones competidoras.

En VS Code:

1. Abre Extensions.
2. Busca GitHub Copilot u otra extensión de IA.
3. Haz clic en Disable para el workspace o desactívala temporalmente.

El objetivo es simple: una sesión, una dirección, un agente principal.

4. Instala y autentica Codex

Elige el cliente Codex que mejor combine con tu flujo:

• Codex CLI;
• extensión de Codex para VS Code;
• aplicación Codex;
• Codex en la web.

Para empezar por la CLI, instala el paquete oficial:

npm install -g @openai/codex

Después inicia sesión:

codex

o, cuando aplique:

codex --login

Sigue el flujo de autenticación mostrado en el terminal.

Si usas la extensión de VS Code, instálala desde la pestaña de extensiones, abre el panel de Codex y sigue las instrucciones de login. Prefiere autenticación con ChatGPT cuando esté disponible. Usa API key solo cuando ese sea tu flujo elegido.

5. Configura Git y GitHub

Vibe coding sin Git se vuelve memoria corta.

Antes de pedir cambios reales, configura tu identidad:

git config --global user.name "Tu Nombre Completo"
git config --global user.email "tuemail@ejemplo.com"

Después, dentro de la carpeta del proyecto:

git init
git status

Si el proyecto aún no está en GitHub, usa el panel Source Control de VS Code o GitHub CLI para publicar el repositorio.

Con GitHub CLI:

gh auth login
gh repo create nombre-del-repositorio --private --source=. --remote=origin --push

Haz commits pequeños. Cada etapa debe ser comprensible.

6. Crea los archivos de dirección del proyecto

El agente necesita contexto persistente.

Crea, como mínimo:

AGENTS.md
README.md
PLANS.md
docs/

Usa AGENTS.md para reglas de trabajo.

Usa README.md para explicar el proyecto.

Usa PLANS.md para organizar etapas pequeñas.

Usa docs/ para registrar decisiones, riesgos y convenciones.

Un primer prompt útil:

Lee AGENTS.md, README.md y PLANS.md.
Entiende el objetivo del proyecto.
No implementes nada todavía.
Lista riesgos, dudas y una primera etapa pequeña de implementación.

7. Entiende la diferencia entre chat y agente

Mucha frustración nace de tratar herramientas diferentes como si fueran iguales.

Chat	Codex integrado al ambiente
Responde preguntas y sugiere fragmentos.	Lee archivos, entiende la estructura y puede editar el proyecto.
Tú copias, pegas y decides dónde encajar.	El agente navega por el repositorio y propone cambios concretos.
Funciona bien para explicación y exploración.	Funciona bien para implementación, revisión y validación.
Depende mucho del contexto que pegas.	Usa el contexto local del workspace, dentro de los límites autorizados.

El chat ayuda a pensar.

El agente ayuda a ejecutar.

Ambos son útiles. Pero no hacen el mismo trabajo.

8. Empieza con un ciclo pequeño

Después del setup, no pidas el sistema entero.

Pide una etapa:

Lee AGENTS.md y PLANS.md.
Implementa solo la primera etapa.
Antes de editar, di qué archivos pretendes alterar.
Después ejecuta las validaciones disponibles y actualiza la documentación necesaria.

Ese es el comienzo correcto.

Ambiente listo. Historial protegido. Agente con contexto. Humano aún dirigiendo.

Bienvenido al vibe coding.