Cursor dentro de un contenedor Docker

Contenido del curso

Web App con FastAPI + Docker

Frontend con Next.js y Cursor IDE

iOS con Swift + Cursor IDE

Android + Cursor IDE

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:007:53

Cursor dentro de un contenedor Docker

Curso de Cursor AI Code Editor

Clase 6 de 25

Clase 6 / 25

Recursos

Trabajar con Cursor dentro de un contenedor Docker te permite desarrollar en un entorno casi idéntico al de producción, mejorar el contexto que recibe la inteligencia artificial y obtener generación de código más precisa. Esta guía está pensada para desarrolladores que ya tienen un Docker Compose corriendo y quieren llevar su flujo de trabajo al siguiente nivel.

Por qué desarrollar dentro de un contenedor con Cursor

La idea central es simple: si tu servicio se ejecuta en producción dentro de un contenedor, tu entorno de desarrollo debería parecerse lo más posible a ese escenario. Y aquí viene lo interesante, Cursor es un fork de Visual Studio Code, así que todas las extensiones del marketplace de VS Code funcionan sin cambios.

Al conectar el editor al contenedor, le das a la IA acceso al mismo intérprete, dependencias y configuración que correrá tu API. Eso se traduce en sugerencias más alineadas con tu stack real.

¿Por qué importa el contexto en Cursor? Porque la calidad del código generado depende de la información que la IA puede leer: tipos, sintaxis del lenguaje y dependencias instaladas. Más contexto, mejor código.

Cómo conectar Cursor a un contenedor en ejecución

Antes de conectar el editor, conviene levantar el entorno con un solo comando. Un Makefile con make start simplifica el proceso, y con docker ps puedes confirmar que los contenedores del proyecto están corriendo.

Luego sigue estos pasos dentro de Cursor:

Abre la sección de extensiones e instala Dev Containers, la extensión que permite adjuntar el editor a un contenedor.
Ejecuta Command + Shift + P y busca Attach to Running Container.
Selecciona el contenedor que te interesa, en este caso el de la API.
Verifica abajo a la izquierda que aparezca el nombre del contenedor, por ejemplo backend API.

Una vez conectado, abre la carpeta del proyecto. Para saber dónde está montado el código, revisa la sección de volumes en tu docker-compose.yml. Si las carpetas se copian a /app/app, ese es el folder que debes abrir con Open Folder.

Qué extensiones instalar para mejorar el contexto de la IA

Una vez Cursor vive dentro del contenedor, la interfaz se ve igual que siempre, pero las extensiones se instalan en ese entorno aislado. Necesitas reinstalar las herramientas que dan contexto al lenguaje.

Python y Pylance como base del tipado

Las dos extensiones imprescindibles para un proyecto Python son:

Python, la extensión oficial de Microsoft con más de 170 millones de descargas.
Pylance, que se instala automáticamente con Python y funciona como Language Server Protocol (LSP).

Pylance es quien detecta errores de sintaxis, problemas de tipado y rutas de importación rotas. Si al abrir un archivo ves un error como FastAPI no se puede importar, casi siempre se resuelve eligiendo el intérprete de Python correcto desde la barra inferior derecha.

¿Qué es un LSP? Es un protocolo que conecta el editor con un servicio de lenguaje para reportar errores, sugerir autocompletado y validar tipos en tiempo real.

Cómo arreglar dependencias no encontradas en el contenedor

Si el error persiste después de seleccionar el intérprete, significa que las dependencias del proyecto no están instaladas en el Python global del contenedor. La solución va dentro del Dockerfile: agrega una variable de entorno que indique a uv dónde debe instalar las dependencias del proyecto.

Después de modificar el Dockerfile, ejecuta make build para reconstruir la imagen. Ten en cuenta una diferencia clave:

Cuando solo reinicias un contenedor, las extensiones instaladas se conservan.
Cuando reconstruyes la imagen, debes volver a instalar las extensiones dentro del nuevo contenedor.

Cómo configurar correctamente el workspace

Un detalle que suele pasar desapercibido es la carpeta que abres como workspace. Si abres una ruta que no contiene el pyproject.toml o el archivo de dependencias, Pylance no podrá resolver las importaciones aunque todo esté instalado.

Para corregirlo:

Usa Add Folder to Workspace y selecciona la carpeta correcta, normalmente /app.
Remueve del workspace el folder anterior que generaba conflicto.
Espera a que el entorno se reinicie y valida que los errores desaparezcan.

Desde Docker Desktop puedes confirmar que la API sigue corriendo y revisar los logs. Si haces una petición a localhost:8000, el servicio responderá igual que antes, solo que ahora estás editando el código directamente dentro del contenedor.

Qué gana tu flujo al desarrollar dentro del contenedor

La ventaja real no es solo organización: es que Cursor recibe el mismo contexto que tendrá el servicio en producción. Pylance ve los tipos reales, el plugin de Python conoce las versiones exactas y la IA genera código alineado con ese entorno.

Esto reduce los típicos funciona en mi máquina y te acerca a un desarrollo donde la generación con inteligencia artificial entiende tu proyecto a fondo. Con esta base lista, el siguiente paso natural es empezar a construir los endpoints del servicio.

¿Ya estás trabajando con Dev Containers en tus proyectos? Cuéntame en los comentarios qué extensiones consideras imprescindibles dentro del contenedor.

José Aarón Madera Chim

Hace 8 meses•editado

Al parecer, se puede crear un archivo para indicar las extensiones que uno desea en el contenedor de Docker: .devcontainer/devcontainer.json

Para evitar reinstalarlas en cada re-build de la imagen

algo así:

How It Connects

With a Dockerfile:

{
  "name": "My Project",
  "build": {
    "dockerfile": "../Dockerfile",
    "context": ".."
  },
  "customizations": {
    "cursor": {
      "extensions": ["ms-python.python"]
    }
  }
}

With Docker Compose:

{
  "name": "My Project",
  "dockerComposeFile": "../docker-compose.yml",
  "service": "app",
  "workspaceFolder": "/workspace",
  "customizations": {
    "cursor": {
      "extensions": ["ms-python.python"]
    }
  }
}

What Happens Under the Hood

You open the project in Cursor and click "Reopen in Container"
Cursor reads devcontainer.json
It runs your docker-compose up (or docker build) for you
After the container starts, Cursor automatically installs the listed extensions inside it
Your editor reconnects to the running container with everything ready

Key Points

Your Dockerfile and docker-compose.yml remain unchanged — devcontainer.json just orchestrates them
The "service" field (for Compose) tells Cursor which container to attach to, in case you have multiple services
You can still run docker compose up manually as usual — devcontainer.json is only used when opening via Cursor/VS Code

Typical Project Structure

my-project/
├── .devcontainer/
│   └── devcontainer.json
├── .cursor/
│   └── extensions.json      # optional, for recommendations UI
├── docker-compose.yml
├── Dockerfile
└── src/

This setup gives you the best of both worlds — full control over your Docker config, with Cursor handling the extension installation automatically on every rebuild.

Comentarios (30)30 comentarios

Jean Nuñez

Hace un año

Felix Adrian Mamani Foronda

Francisco Ponce

Daniel Flores

Jeremias Ezequiel Gonzalez

Alfredo Olmedo

Earvin Saúl Pérez Ramos

Mateo Montoya Henao

Ricardo González

Yan Arlex Vallejo Rosas

Raúl Linares

Julio Sarango

Salvador Pallares

Martin Lazzeri

Hace 6 meses

LEWIS SARMIENTO

Gerencia Sistemas

Hace 4 meses

Jhon Jairo Diaz Avendaño

Hace 7 meses

Ana Milena Baez Gayon

MARIA TERESA PANIAGUA RIVERA

Hace 8 meses

Dario Bublitz

Web App con FastAPI + Docker

Vibe coding con Cursor en dos semanas

Stack tecnológico para plataforma educativa online

Configuración de contexto y reglas en Cursor para FastAPI

Setup de FastAPI con Cursor paso a paso

Ejecución autónoma de setup con Cursor

Cursor dentro de un contenedor Docker

Migraciones y modelos ORM con Cursor y Alembic

Creación de servicios y endpoints en FastAPI con Docker

Pruebas unitarias en FastAPI con PyTest

Frontend con Next.js y Cursor IDE

Cursor Agent para front-end sin configuración

Creación y configuración de Cursor Rules para proyectos Next.js

Mejora visual de landing pages con imágenes y tokens CSS

Configuración de estilos globales SCSS y páginas dinámicas en Next.js

Configuración de Vitest para pruebas unitarias en Next.js

Página completa con un solo prompt en Cursor

E2E testing con Playwright MCP en Cursor

iOS con Swift + Cursor IDE

Configuración de Cursor con Xcode para desarrollo iOS nativo

Configura reglas y contexto en Cursor

Genera UI en SwiftUI con prompts en Cursor

Cursor genera capas data y domain en iOS

Conexión de view models con capas domain y data

Android + Cursor IDE

Setup de Cursor para apps Android con Kotlin

Cursor genera una app Android desde cero

Corrección de errores de dependencias con Cursor en Android Studio

Cursor en equipo: entrega frontend en un día

Cursor dentro de un contenedor Docker

Progreso del curso

Web App con FastAPI + Docker

Frontend con Next.js y Cursor IDE

iOS con Swift + Cursor IDE

Android + Cursor IDE

Recursos

Recursos