Cómo conectar API Keys personalizadas e indexar el contexto del espacio de trabajo en CodeGPT para VS Code

En Visual Studio Code, utilizar CodeGPT simplemente como una ventana de chat convencional limita al modelo a interactuar con los fragmentos de código que se copian y pegan manualmente. Para convertir a CodeGPT en un asistente con conciencia total del repositorio, capaz de explicar lógica dispersa entre múltiples módulos y ejecutar refactorizaciones precisas, los desarrolladores deben configurar dos pilares: conectar claves API personalizadas (modelo BYOK y endpoints personalizados) e indexar el espacio de trabajo local (Codebase Indexing). Con este entorno configurado, la herramienta de búsqueda semántica (Semantic Search Tool) y los distintos modos de perfil permiten auditar y modernizar el código directamente desde el editor.

1. Conexión de API Keys personalizadas (BYOK y endpoints personalizados)

CodeGPT funciona mediante un esquema híbrido: los nuevos usuarios disponen de un plan gratuito básico (30 interacciones mensuales), pero el flujo de trabajo profesional recurre comúnmente al modelo BYOK (Bring Your Own Key) o a suscripciones corporativas. Al utilizar tus propias claves, eliminas los límites de mensajes impuestos por la plataforma y abonas el consumo de tokens directamente al proveedor del modelo.

Pasos para configurar proveedores y credenciales

1. Instalación y sincronización de cuenta: En el Marketplace de extensiones de VS Code, busca e instala CodeGPT: AI Coding Agents & Chat (publicada por DanielSanMedium). Abre el panel lateral de CodeGPT e inicia sesión con Google, GitHub o correo electrónico para sincronizar tu perfil.
2. Acceder a la administración de proveedores:
   • En la parte inferior del chat de CodeGPT, haz clic en el botón Manage Models y selecciona la pestaña Providers.
   • Como alternativa, abre la paleta de comandos de VS Code (Ctrl+Shift+P en Linux/Windows o Cmd+Shift+P en macOS) y ejecuta el comando CodeGPT: Set API KEY.
3. Seleccionar el proveedor de IA:
   • CodeGPT cuenta con soporte nativo para OpenAI, Anthropic, Google AI Studio, DeepSeek, Mistral, Cohere, Groq, Cerebras y Perplexity, así como para motores locales como Ollama y LM Studio.
   • Pega la clave secreta obtenida en la consola oficial del proveedor (por ejemplo, en OpenAI o Anthropic Console). Si tu cuenta pertenece a una organización específica, puedes ingresar tu Organization ID.
4. Configuración de endpoints personalizados compatibles con OpenAI (Custom Provider):
   • Si utilizas pasarelas internas de empresa, servidores propios (como vLLM o instancias remotas de Ollama) o proxies como OpenRouter, selecciona Custom en la lista de proveedores.
   • Introduce el nombre del modelo de destino (por ejemplo, cognitivecomputations/dolphin3.0-mistral-24b:free o la etiqueta de tu modelo privado).
   • Pega tu API Key correspondiente.
   • Introduce la URL completa del endpoint de compleción (Custom Link, apuntando al endpoint HTTP /chat/completions).
   • Haz clic en Connect para registrar la conexión.
5. Requisito fundamental tras la configuración BYOK: Tras guardar tu clave, debes seleccionar explícitamente un modelo activo en el menú desplegable superior del chat. Si intentas enviar un mensaje sin tener un modelo seleccionado, la extensión mostrará el error: "You must select a model first".

2. Indexación del espacio de trabajo local (Augmented Context)

Por defecto, los modelos de lenguaje no tienen visibilidad de los archivos que no están abiertos en el editor ni de la jerarquía del proyecto. La función Codebase Indexing de CodeGPT genera un índice vectorial local para dotar al asistente de contexto sobre todo el repositorio.

Selección de texto puntual vs. indexación del repositorio

• Resaltado de código (Highlighting): Adecuado para resolver errores en funciones aisladas, hacer consultas sintácticas rápidas o depurar bloques concretos sin cargar todo el proyecto.
• Indexación del Codebase: Indispensable cuando los cambios afectan a múltiples archivos, las interfaces están definidas en otros directorios o se necesita que la IA respete los patrones arquitectónicos del proyecto.

Cómo crear el índice del espacio de trabajo

1. En la barra lateral de CodeGPT, localiza el menú principal y haz clic en el botón Codebase dentro de la sección Augmented Context.
2. Haz clic en Create Codebase Index.
3. En el cuadro de diálogo de selección de carpetas, elige la raíz de tu proyecto o el directorio relevante.
4. CodeGPT escaneará la estructura de archivos y construirá una base de vectores local.
5. Al finalizar el proceso, el asistente activará automáticamente la Semantic Search Tool (Herramienta de Búsqueda Semántica).

Métodos para inyectar contexto en la conversación

• Búsqueda semántica automática: Cuando realizas preguntas que dependen de otras capas del código, CodeGPT invoca automáticamente la Semantic Search Tool para recuperar los fragmentos relevantes e introducirlos en el contexto.
• Anclaje manual de archivos: Haz clic en el botón +Add Context y elige #Files para fijar archivos clave, o escribe el símbolo @ en el campo de texto para referenciar archivos abiertos o símbolos específicos.
• Inclusión automática del archivo actual: En los ajustes de CodeGPT (icono de engranaje ⚙️), puedes activar la opción que añade automáticamente el archivo activo en el editor al contexto de cada mensaje.

3. Explicación de código con contexto de todo el proyecto

Comprender sistemas heredados o flujos de trabajo extensos requiere ir más allá de la sintaxis local y analizar cómo interactúan las distintas piezas del software.

Modo de perfil recomendado: Search Mode

CodeGPT ofrece tres perfiles de funcionamiento en el selector del chat:

• Chat Mode: Modo conversacional estándar sin acceso a herramientas de archivos.
• Search Mode (Recomendado para explicaciones): Modo de solo lectura. Permite a la IA explorar la jerarquía de carpetas, ejecutar búsquedas semánticas y leer archivos vinculados, garantizando un análisis profundo sin riesgo de modificaciones accidentales.
• Agent Mode: Modo con permisos completos de lectura, escritura y ejecución de comandos en la terminal.

Flujo de trabajo para explicar código

1. Seleccionar el código: En el editor de VS Code, resalta la función, clase o bloque complejo que deseas comprender.
2. Ejecutar el comando /Explain:
   • En la entrada de chat de CodeGPT, escribe /Explain y presiona Enter.
   • O haz clic derecho sobre la selección en el editor y elige Explain CodeGPT.
3. Análisis contextualizado: Al estar indexado el espacio de trabajo, la explicación no se limita a describir las instrucciones, sino que detalla de dónde proceden los parámetros, qué métodos auxiliares se llaman en otros archivos y qué patrones de diseño se están aplicando.
4. Preguntas de profundización: En Search Mode, puedes realizar consultas específicas como:
   • «¿En qué rutas de la API se invoca este middleware?»
   • «Explica la relación entre esta entidad y los repositorios de persistencia del proyecto.»

4. Refactorización segura y progresiva

Refactorizar sin contexto global suele provocar incompatibilidades en firmas de funciones o inconsistencias con las convenciones del repositorio. CodeGPT ofrece comandos estructurados y control de herramientas para realizar refactorizaciones confiables.

Flujo de refactorización

1. Delimitar el bloque a mejorar: Selecciona el código que requiere modernización, optimización o modularización.
2. Ejecutar /Refactor:
   • En el chat, escribe /Refactor junto con las instrucciones específicas (por ejemplo: /Refactor convierte esta cadena de callbacks a async/await y extrae la validación a una función independiente), y pulsa Enter.
   • O pulsa clic derecho y selecciona Refactor CodeGPT.
3. Revisión y aplicación de cambios:
   • En Search Mode o Chat Mode: CodeGPT genera en el panel de conversación el bloque de código refactorizado y un desglose de los cambios. Puedes pulsar el botón Insert code (icono de flecha en la esquina superior derecha del bloque de código) para aplicarlo directamente en el archivo abierto.
   • En Agent Mode: CodeGPT ejecuta su herramienta interna Edit File para modificar el archivo en disco. Si no tienes activada la auto-aprobación, la extensión te solicitará confirmación antes de guardar los cambios.

Recomendaciones para refactorizaciones seguras

• Estrategia en dos fases (Search → Agent): Utiliza primero Search Mode para evaluar el impacto de la refactorización en el resto del espacio de trabajo. Cuando la propuesta esté validada, cambia a Agent Mode para aplicar los cambios en los archivos.
• Validación mediante pruebas en terminal: En Agent Mode, pide a CodeGPT que ejecute la suite de pruebas del proyecto (npm test, pytest, etc.) utilizando la herramienta interna Run Terminal Command, asegurando que no se introduzcan regresiones.
• Actualización periódica del índice: Tras refactorizaciones masivas o tras fusionar ramas de Git, vuelve a ejecutar el indexado desde el menú Codebase para mantener la base vectorial sincronizada con el estado actual del repositorio.

Referencias

• Configuration | CodeGPT
• CodeGPT Chat | CodeGPT
• Profile Modes | CodeGPT
• Internal Tools | CodeGPT
• Explain CodeGPT | CodeGPT
• Refactor CodeGPT | CodeGPT
• 🤖 AI Providers | CodeGPT
• Custom | CodeGPT
• CodeGPT: AI Coding Agents & Chat - Visual Studio Marketplace