Claude Bridge

Un servidor MCP que permite la colaboración entre Claude Code y los modelos GLM de Z.ai: utiliza Claude Opus para la planificación mientras GLM se encarga de la implementación.

Combina las fortalezas de Claude Code y GLM de Z.ai en un solo flujo de trabajo. Este servidor MCP permite que Opus se encargue de la planificación de alto nivel mientras GLM aborda la implementación, coordinados a través de una cola de tareas compartida y ejecutándose simultáneamente en terminales separadas. Ejecuta Claude Code con tu suscripción Max o API para la arquitectura, y Claude Code con Z.ai (GLM) para la ejecución; ambos trabajando juntos al mismo tiempo.

Tabla de contenidos

• Por qué existe esto

• Ejemplo rápido

• Características

• Cuándo NO usar esto

• Requisitos previos

• Inicio rápido

• Documentación

• Funciona también con otros clientes MCP

• Seguridad

• Licencia

Related MCP server: Herald

Por qué existe esto

Tienes una suscripción a Claude pero estás alcanzando los límites. Obtener una segunda suscripción a Claude es costoso (o actualizar puede ser demasiado caro), pero una suscripción a Z.ai cuesta menos y GLM programa tan bien como Sonnet.

La pregunta: ¿Cómo haces que Claude y GLM trabajen juntos?

La respuesta: Claude Bridge. Un servidor MCP que coordina a ambos a través de una cola de tareas compartida.

┌─────────────────────────┐                    ┌─────────────────────────┐
│   Terminal 1            │                    │   Terminal 2            │
│   Claude Opus           │                    │   Z.ai GLM              │
│   (Architect)           │                    │   (Executor)            │
│                         │    Claude Bridge   │                         │
│   • Plans features      │◄──────────────────►│   • Pulls tasks         │
│   • Designs architecture│    (Shared Queue)  │   • Writes code         │
│   • Makes decisions     │                    │   • Reports back        │
└─────────────────────────┘                    └─────────────────────────┘

Ejemplo rápido

Terminal 1 (Opus): "Envía una tarea para implementar la autenticación JWT"

Terminal 2 (GLM): "Extrae la siguiente tarea" → implementa → "Completa la tarea"

Terminal 1: "¿Qué completó el ejecutor?" → revisa los resultados

Características

• Cola de tareas — Basada en prioridades con dependencias y categorías

• Estado compartido — Enfoque del proyecto y decisiones visibles para ambos

• Contexto de sesión — Reanuda donde lo dejaste

• Aclaraciones — El ejecutor hace preguntas, el arquitecto responde

• Consciente de los tokens — Diseñado para minimizar el uso de Opus

Cuándo NO usar esto

Si estás utilizando un marco de planificación como Get-Shit-Done (GSD), no necesitas este puente. Marcos como GSD almacenan el contexto en archivos de proyecto (.planning/) que ambas terminales pueden leer directamente. Los comandos de barra como /gsd:plan-phase y /gsd:execute-phase funcionan en cualquier terminal.

Usa Claude Bridge para:

• Tareas ad-hoc, correcciones rápidas, investigación puntual

• Proyectos sin un marco de planificación

• Continuidad de sesión entre reinicios

Omite el puente si:

• Usas GSD o marcos de planificación basados en archivos similares

• Ambas terminales comparten el sistema de archivos del proyecto

Requisitos previos

• Node.js 18+ — Descargar

• Claude Code CLI — Instalación

• Cuenta de Z.ai — Para acceso a GLM (z.ai)

• Dos ventanas de terminal

Configuración del perfil de terminal

¿La misma suscripción en ambas terminales? Simplemente ejecuta claude en cada una; no se necesita configuración de perfil.

¿Claude + Z.ai GLM? Agrega esta función a tu perfil de shell:

Windows PowerShell (notepad $PROFILE):

function use-glm {
    $env:ANTHROPIC_BASE_URL = "https://api.z.ai/api/anthropic"
    $env:ANTHROPIC_AUTH_TOKEN = "your_zai_api_key_here"
    Write-Host ">>> GLM ACTIVE (Executor mode)" -ForegroundColor Cyan
}

macOS/Linux (~/.bashrc o ~/.zshrc):

use-glm() {
    export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
    export ANTHROPIC_AUTH_TOKEN="your_zai_api_key_here"
    echo ">>> GLM ACTIVE (Executor mode)"
}

Uso:

• Terminal 1: Simplemente ejecuta claude (usa tu suscripción de Claude)

• Terminal 2: Ejecuta use-glm, luego claude (usa la API de Z.ai)

Consulta GUIDE.md para obtener detalles completos de la configuración.

Inicio rápido

# 1. Clone and build
git clone https://github.com/Joncik91/claude-bridge-server.git
cd claude-bridge-server
./setup.sh          # or setup.bat on Windows

# 2. Configure MCP (see GUIDE.md for details)
claude mcp add --scope user --transport stdio claude-bridge -- node /path/to/server/dist/index.js

Documentación

GUIDE.md — Configuración completa, configuración de terminal, uso y solución de problemas

Funciona también con otros clientes MCP

Aunque está diseñado para Claude + GLM, el puente es un servidor MCP estándar; funciona con cualquier CLI compatible con MCP:

• Dos instancias de Claude Code (mismas o diferentes suscripciones)

• Gemini CLI

• OpenCode

• Qwen Code

• Cualquier otro cliente MCP

Seguridad

Claude Bridge se sitúa entre dos CLI que contienen tokens de API reales. Tres implicaciones que vale la pena explicitar.

• Los tokens de API nunca pasan por el puente. El protocolo del servidor transporta tareas, estados y resultados, no credenciales. Cada terminal se autentica directamente contra su propio proveedor (tu suscripción de Claude en un lado, tu clave de Z.ai en el otro). El patrón de perfil de shell en Requisitos previos existe para que la sesión de terminal establezca ANTHROPIC_AUTH_TOKEN; el puente nunca lo lee.

• No confirmes use-glm con una clave literal. Los fragmentos de perfil de shell en este README y GUIDE.md usan un marcador de posición; reemplázalo con ${ZAI_API_KEY} o similar y carga el secreto desde un administrador de contraseñas / llavero del sistema. Una clave literal en ~/.bashrc es una clave literal en cada copia de seguridad de tu directorio personal.

• La cola de tareas compartida es local al proceso del puente. Las tareas, aclaraciones y notas del revisor viven en el estado en memoria del puente. No dirijas dos proyectos no relacionados a la misma instancia del puente; la cola es de inquilino único por diseño.

Para uso en equipo: cada par de terminales arquitecto+ejecutor debe ejecutar su propio proceso de puente, no compartir uno. El transporte MCP es stdio en la máquina local; nada escucha en un puerto de red.

Licencia

MIT — ver LICENSE.

Reconocimientos

• Creado para Claude Code por Anthropic

• Diseñado para la integración con GLM de Z.ai