Ilustración técnica para: VS Code Agent Mode: cómo orquestar Claude, Codex y Gemini

Claude, Codex y Gemini en VS Code junto a Copilot: qué funciona en octubre de 2026


A 7 de octubre de 2026 (VS Code 1.141), el editor admite tres harnesses de agente además del suyo propio: Copilot, Claude y Codex, más un destino Cloud para agentes que trabajan en remoto y devuelven una pull request, según la documentación oficial de harnesses. Gemini no figura como harness: en VS Code llega como modelo seleccionable en Copilot o a través de Gemini Code Assist y Gemini CLI, que desde el 18 de junio de 2026 ya no atienden a cuentas personales de Google pero siguen disponibles con licencias Standard o Enterprise y, en el caso de Gemini CLI, con claves de API de pago. Esta guía resume qué hay que activar para cada agente, quién factura cada sesión, dónde se configura MCP en cada caso y qué revisar cuando algo no aparece.

Qué agentes admite VS Code hoy

El antiguo "modo agente" ya no es un interruptor único. Al iniciar una sesión eliges por separado el Session Target (qué harness ejecuta la sesión y dónde), el rol de agente (Agent, Plan o Ask), el modelo, el nivel de permisos y el aislamiento de código (carpeta actual o worktree nuevo). Cambiar de modelo no cambia de harness, y el mismo modelo puede estar disponible en más de uno, según la página de conceptos de harnesses.

Session TargetCómo se activaDónde correQuién factura
LocalIntegrado, sin configuraciónExtension host de VS Code, sobre el workspace activoPlan de Copilot o los modelos BYOK configurados en VS Code
CopilotIntegrado; usa la misma cuenta de GitHub que el chatAgent Host en tu máquina, en un host remoto o en un Dev ContainerPlan de Copilot; modelos BYOK con chat.agentHost.byokModels.enabled (experimental)
ClaudeActivado por defecto; se controla con github.copilot.chat.claudeAgent.enabledTu máquina, en la carpeta actual o en un worktreePlan de Copilot o tu propia clave de Claude (BYOK), según el modelo que elijas
CodexNo aparece por defecto: instala la extensión de OpenAI o activa chat.agentHost.codexAgent.enabled (experimental)Tu máquina, en la carpeta actual o en un worktreeCopilot (Pro+ en el Agent Host; Pro+ o Max en la extensión), tu cuenta de ChatGPT o, en la extensión, una clave de API de OpenAI
CloudCopilot cloud agent; los agentes cloud de Claude y Codex se activan en los ajustes de tu cuenta de CopilotInfraestructura remota del proveedor, contra un repositorio de GitHubPlan de Copilot; los agentes cloud de Claude y Codex consumen minutos de GitHub Actions y AI credits

Agent Host: qué es y por qué importa

El Agent Host es un proceso dedicado, separado del extension host, que ejecuta los harnesses y es dueño de las sesiones. Se comunica con las ventanas mediante el Agent Host Protocol (AHP), lo que permite abrir la misma sesión desde varias ventanas, ejecutarla en una máquina remota o dejar que un turno siga corriendo aunque cierres la ventana.

Las notas de versión lo mencionan al menos desde VS Code 1.126 (24 de junio de 2026), cuando VS Code adopta el Agent Host Protocol; en 1.128 ya se activaba con chat.agentHost.enabled, y en 1.129 (15 de julio) Microsoft anunció que empezaba a desplegarlo de forma gradual. Las notas posteriores siguen describiéndolo como en desarrollo activo. En VS Code 1.141 Microsoft indica que el harness de Copilot sobre el Agent Host se está convirtiendo gradualmente en el predeterminado para usuarios empresariales con los experimentos de VS Code activados. Que en tu instalación ya lo sea depende de ese despliegue, no de la versión.

Para pasar una conversación de un agente a otro existe el handoff: desde una sesión Local abres el desplegable Session Target, eliges Copilot, Claude, Codex o Cloud, y VS Code traslada el historial y el contexto. Solo puede iniciarse desde una sesión Local; las sesiones que ya corren en el Agent Host no muestran ese desplegable.

Cómo activar cada agente

Copilot

No requiere nada aparte de la cuenta de Copilot con la que usas el chat. El harness usa el Copilot SDK, el mismo runtime que Copilot CLI, así que las instrucciones personalizadas y las Agent Skills del repositorio sirven en ambos.

Claude: harness integrado o extensión de Anthropic

Hay dos caminos distintos y conviene no confundirlos:

  • Harness Claude de VS Code. No se instala nada: está activado por defecto y usa el Claude Agent SDK de Anthropic. Se autentica con tu suscripción de Copilot (modelos enrutados por Copilot) o con una clave propia, por ejemplo ANTHROPIC_API_KEY en el entorno o en el objeto env de ~/.claude/settings.json. Desde VS Code 1.133 el selector de modelos agrupa los modelos bajo Anthropic y Copilot, y el que eliges en cada turno decide quién paga ese turno. Sus modos de permiso son Edit automatically, Request approval y Plan.
  • Extensión Claude Code de Anthropic (anthropic.claude-code). Según la documentación de Anthropic, requiere VS Code 1.94.0 o posterior y una suscripción de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console; también admite Amazon Bedrock, Google Cloud Agent Platform y Microsoft Foundry. También se instala en Cursor y en otros forks de VS Code. La extensión trae su propia copia del CLI, pero para escribir claude en la terminal integrada necesitas instalar el CLI por separado.

La diferencia práctica está en la factura y en la interfaz: el harness integra a Claude en las sesiones de VS Code (Agents window, handoff, worktrees) y puede tirar de Copilot; la extensión es la interfaz propia de Anthropic y consume tu cuenta de Anthropic o del proveedor que configures.

Codex: extensión de OpenAI o Agent Host

  • Extensión de OpenAI (openai.chatgpt). Es la vía estable. Según la documentación de autenticación de OpenAI, la extensión admite iniciar sesión con tu cuenta de ChatGPT o con una clave de API; con clave, el uso se cobra a tarifa de API en tu cuenta de OpenAI Platform. Además, según GitHub, la extensión ofrece la opción Sign in with Copilot a suscriptores de Copilot Pro+ y Copilot Max (integración en vista previa pública), con el uso sujeto a los límites y la facturación de GitHub.
  • Codex sobre el Agent Host (experimental). Activa chat.agentHost.codexAgent.enabled para tenerlo en la Agents window; para usarlo también en la vista de Chat, activa además chat.editor.codex.preferAgentHost y reinicia cuando VS Code lo pida. Admite dos cuentas: Copilot (requiere Copilot Pro+) o ChatGPT, para la que basta una cuenta gratuita. Sus presets de aprobación son Default Permissions, Auto-Review y Full Access.

En cada ventana solo aparece una implementación de Codex: si prefieres la del Agent Host en la vista de Chat, sustituye a la de la extensión en esa ventana.

Agentes en la nube

El destino Cloud agrupa el Copilot cloud agent y los agentes cloud de Claude y Codex. Estos dos siguen en vista previa pública, están disponibles en los planes Copilot Pro, Pro+, Max, Business y Enterprise, y se activan en las políticas de tu cuenta de Copilot. No necesitas la extensión del proveedor para lanzar una sesión cloud, pero esa sesión no ve tus herramientas locales ni la salida de tu terminal.

Qué pasó con Gemini en VS Code

El 18 de junio de 2026 las extensiones de Gemini Code Assist para IDE y Gemini CLI dejaron de atender peticiones de los niveles Gemini Code Assist for individuals, Google AI Pro y Google AI Ultra, es decir, de quien entraba con su cuenta personal de Google. Google lo había anunciado el 19 de mayo en su blog para desarrolladores y propone a esos usuarios migrar a la familia Antigravity (la aplicación de escritorio Antigravity y Antigravity CLI). Gemini sigue teniendo tres vías en VS Code:

  • Licencias Gemini Code Assist Standard o Enterprise: según el mismo anuncio, si tu organización usa Gemini CLI o las extensiones de IDE con esas licencias, el acceso sigue sin cambios. Es la vía para seguir usando la extensión Gemini Code Assist en VS Code.
  • Gemini CLI con clave de API de pago: Google indica que Gemini CLI sigue accesible con claves de pago de Gemini API y de Gemini Enterprise Agent Platform. Lo ejecutas en la terminal integrada y lo conectas al editor con la extensión "Gemini CLI Companion", que la documentación de integración con IDE mantiene para VS Code y editores compatibles. Esa misma documentación muestra el aviso de que, para el nivel gratuito y los usuarios de Google One, Gemini CLI fue sustituido por Antigravity CLI el 18 de junio de 2026.
  • Gemini como modelo: el catálogo de modelos de Copilot incluye hoy Gemini 3.7 Flash y Gemini 3.8 Flash en disponibilidad general. Gemini 3.1 Pro se retiró de Copilot el 1 de septiembre de 2026 y Gemini 3.5 y 3.6 Flash el 2 de octubre, así que hoy no queda ningún Gemini Pro en el catálogo. Los eliges en el selector de modelos; es un modelo dentro de Copilot, no un agente propio.

Lo que ya no funciona es entrar con una cuenta personal de Google (gratuita, AI Pro o AI Ultra): para esas cuentas Google recomienda Antigravity, y si quieres seguir en VS Code te quedan la clave de API de pago o una licencia de empresa. Más contexto en el artículo sobre la retirada de Gemini CLI.

Quién paga cada sesión

Elegir "Claude" o "Codex" en el desplegable no fija por sí solo quién factura. Lo decide la cuenta con la que autenticas y, en el harness de Claude y en Codex sobre el Agent Host, el grupo del modelo que eliges en el selector:

  • Copilot: desde el 1 de junio de 2026, los planes mensuales de Copilot ya no cuentan premium requests con multiplicador por modelo: cobran según el modelo y los tokens consumidos, contra una asignación de GitHub AI Credits. Los planes anuales anteriores pueden seguir con el sistema por peticiones hasta que caduquen.
  • Harness Claude: modelos bajo Copilot consumen tu plan de Copilot; modelos bajo Anthropic se cobran a tu clave o proveedor BYOK. Puedes cambiar de grupo entre turnos de la misma sesión.
  • Codex en el Agent Host: modelos bajo Copilot o bajo ChatGPT; VS Code guarda el proveedor con la sesión.
  • Extensión Claude Code: factura a tu cuenta de Anthropic o al proveedor que configures (Bedrock, Google Cloud, Foundry).
  • Extensión de Codex: depende de cómo inicies sesión. Con ChatGPT o con clave de API factura OpenAI; con Sign in with Copilot (Pro+ o Max) el uso queda sujeto a la facturación de GitHub.
  • Agentes cloud de Claude y Codex: consumen minutos de GitHub Actions y AI credits de tu plan de Copilot.

Para vigilar el gasto de Claude Code desde el editor, este artículo sobre statusline y OpenTelemetry cubre las opciones.

Dos agentes, un repositorio: worktrees y sus límites

Si lanzas dos agentes sobre la misma carpeta, ambos escriben en los mismos archivos. La herramienta que ofrece VS Code para evitarlo es la opción New Worktree, disponible para Copilot, Claude y Codex, con estas condiciones según la documentación:

  • Solo existe en la Agents window; las sesiones abiertas desde la vista de Chat usan siempre el workspace actual, y el harness Local escribe siempre en el workspace activo.
  • El worktree parte del estado confirmado (committed) de la rama base: no incluye cambios sin commit ni archivos sin seguimiento. Los archivos ignorados por git, como .env o las dependencias instaladas, tampoco, salvo que los añadas con git.worktreeIncludeFiles; para carpetas grandes existe git.worktreeSymlinkFolders (experimental), cuyos cambios afectan a la carpeta original.
  • Las sesiones en worktree usan el permiso Allow all sin opción de cambiarlo. El worktree aísla los cambios de código, pero no restringe comandos ni red: para eso está el sandboxing de agentes.
  • Las sesiones en Dev Container no admiten New Worktree.

Si la tarea depende de cambios que aún no has confirmado, la alternativa es trabajar en modo carpeta y lanzar los agentes uno detrás de otro. La guía oficial Delegate two tasks without mixing their changes recorre el caso de dos tareas en worktrees separados, y este artículo sobre git worktrees con agentes en paralelo explica el mecanismo de git.

Dónde vive la configuración MCP de cada agente

Cada herramienta lee su propio archivo, y no todos usan la misma clave:

Quién lo leeArchivoFormato
VS Code (formato propio).vscode/mcp.json y el mcp.json del perfil de usuarioObjeto servers
VS Code y Agent Host (formato portable).mcp.json en la raíz del proyecto; ~/.copilot/mcp-config.json a nivel de usuarioObjeto mcpServers
Claude Code (CLI y extensión).mcp.json para el scope de proyecto; ~/.claude.json para los scopes local y userObjeto mcpServers
Codex (CLI, extensión y app de escritorio)~/.codex/config.toml o .codex/config.toml en proyectos de confianzaTablas [mcp_servers.<nombre>] en TOML

Tres particularidades de la configuración, según la documentación de MCP de VS Code y la de Claude Code:

  • El Agent Host no lee .vscode/mcp.json directamente: VS Code le reenvía esos servidores, salvo los que piden entrada interactiva (variables ${input:...}). El comando MCP: Add Server ya marca .vscode/mcp.json como destino obsoleto y recomienda los portables.
  • .mcp.json en la raíz del repositorio es el punto común: lo leen VS Code, el Agent Host y el scope de proyecto de Claude Code. Codex no lo usa; tiene su propio config.toml.
  • No existe ~/.claude/mcp.json: los scopes local y user de Claude Code viven en ~/.claude.json.

Un .mcp.json compartido tiene esta forma:

{
  "mcpServers": {
    "mi-servidor": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Y el equivalente para Codex en ~/.codex/config.toml:

[mcp_servers.mi-servidor]
url = "https://example.com/mcp"

Si un agente o un servidor no aparece: checklist

  • Codex no sale en Session Target: no se lista por defecto. Instala la extensión de OpenAI o activa chat.agentHost.codexAgent.enabled; con este último, en la vista de Chat necesitas también chat.editor.codex.preferAgentHost y reiniciar.
  • Claude no sale: comprueba que github.copilot.chat.claudeAgent.enabled no esté desactivado.
  • Quieres usar Claude o Codex sin iniciar sesión en GitHub: es experimental y requiere chat.agentHost.allowSignedOutWhenUsable, además de una clave de Claude o una sesión de ChatGPT.
  • Un servidor MCP funciona en una sesión Local pero no en una de Copilot, Claude o Codex: si usa ${input:...}, VS Code no lo reenvía al Agent Host. La documentación recomienda .mcp.json o ~/.copilot/mcp-config.json para la configuración que el Agent Host lee de forma nativa, pero no indica que esos archivos admitan ${input:...}, así que el valor tendrá que llegar al servidor por otra vía. Además, las sesiones de Copilot solo acceden por ahora a servidores MCP locales que no requieren autenticación.
  • Has puesto chat.mcp.autostart en never y los servidores arrancan igual: ese ajuste no controla los servidores que lanza el Agent Host.
  • Ningún servidor del workspace arranca: en modo restringido (workspace sin confianza) la configuración MCP del workspace está bloqueada.
  • Necesitas el log: ejecuta MCP: List Servers, elige el servidor y pulsa Show Output.
  • Extensión de Claude Code: escribe /mcp en el panel para ver, añadir o reconectar servidores; claude mcp add en la terminal (con el CLI instalado aparte) guarda en la misma configuración.
  • Gemini Code Assist no responde con una cuenta personal: no es un fallo que vaya a corregirse; el servicio dejó de atender esas cuentas el 18 de junio de 2026.

Preguntas frecuentes

¿Puedo usar Claude en VS Code sin instalar la extensión de Anthropic?

Sí. El harness Claude viene activado por defecto en VS Code y usa el Claude Agent SDK. Puedes pagarlo con tu plan de Copilot o con tu propia clave de Claude, eligiendo el modelo en el grupo Copilot o en el grupo Anthropic del selector.

¿Necesito Copilot Pro+ para usar Codex en VS Code?

Solo si quieres pagar Codex con Copilot: en el Agent Host exige Pro+, y la opción Sign in with Copilot de la extensión de OpenAI está disponible para Pro+ y Max. Sin Copilot, la extensión admite iniciar sesión con ChatGPT o con una clave de API, y en el Agent Host basta una cuenta de ChatGPT, que según la documentación de VS Code puede ser gratuita.

¿Sigue funcionando Gemini Code Assist en VS Code?

Con licencias Standard o Enterprise, sí. Con cuentas individuales, Google AI Pro o Google AI Ultra, no: las extensiones y Gemini CLI dejaron de atender esas cuentas el 18 de junio de 2026 y Google recomienda migrar a Antigravity. Gemini CLI, con su extensión Gemini CLI Companion, sigue disponible con claves de pago de Gemini API.

¿Qué archivo MCP comparten Copilot y Claude Code?

.mcp.json en la raíz del repositorio, con la clave mcpServers. Lo leen VS Code, el Agent Host y el scope de proyecto de Claude Code. Codex usa config.toml.

¿Puedo pasar una conversación a Claude o Codex sin empezar de cero?

Sí, si la conversación está en una sesión Local: abre el desplegable Session Target y elige Copilot, Claude, Codex o Cloud, y VS Code traslada el historial y el contexto. Las sesiones que ya corren en el Agent Host, incluidas las del harness Copilot, no muestran ese desplegable, así que el handoff no puede iniciarse desde ellas.

Compartir X LinkedIn