--- title: "Setup inicial para vibe coding: preparando VS Code con Codex" summary: "Una guía directa para preparar OpenAI, VS Code, Codex, Git y GitHub antes de empezar a trabajar con agentes de IA." slug: "setup-inicial-vibe-coding-codex" language: "es" publishedAt: "2026-05-25" updatedAt: null tags: - "guia" - "setup" - "vscode" - "codex" - "github" translationOf: "pt/setup-inicial-vibe-coding-codex" translationStatus: "current" --- 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](https://developers.openai.com/) - [Plataforma de desarrolladores de OpenAI](https://platform.openai.com/) Si eliges usar una API key: 1. Accede a la [plataforma de desarrolladores de OpenAI](https://platform.openai.com/). 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: ```bash winget install -e --id Microsoft.VisualStudioCode ``` En macOS, usando Homebrew: ```bash 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: ```bash npm install -g @openai/codex ``` Después inicia sesión: ```bash codex ``` o, cuando aplique: ```bash 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: ```bash git config --global user.name "Tu Nombre Completo" git config --global user.email "tuemail@ejemplo.com" ``` Después, dentro de la carpeta del proyecto: ```bash 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: ```bash 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: ```txt 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: ```txt 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: ```txt 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.