Claude Bridge

Claude Code와 Z.ai의 GLM 모델 간의 협업을 가능하게 하는 MCP 서버입니다. Claude Opus를 사용하여 계획을 세우고 GLM이 구현을 처리하도록 하세요.

Claude Code와 Z.ai의 GLM의 강점을 하나의 워크플로우로 결합하세요. 이 MCP 서버를 사용하면 Opus가 상위 수준의 계획을 담당하고 GLM이 구현을 처리하며, 공유 작업 대기열을 통해 조정되어 별도의 터미널에서 동시에 실행됩니다. 아키텍처 설계를 위해 Max 구독 또는 API로 Claude Code를 실행하고, 실행을 위해 Z.ai(GLM)와 함께 Claude Code를 실행하여 두 모델이 동시에 협업하도록 하세요.

목차

• 이 프로젝트의 목적

• 간단한 예시

• 주요 기능

• 사용을 권장하지 않는 경우

• 사전 요구 사항

• 빠른 시작

• 문서

• 다른 MCP 클라이언트와의 호환성

• 보안

• 라이선스

Related MCP server: Herald

이 프로젝트의 목적

Claude 구독을 사용 중이지만 제한에 걸리는 경우가 있습니다. 두 번째 Claude 구독을 추가하는 것은 비용이 많이 들 수 있지만, Z.ai 구독은 비용이 저렴하며 GLM은 Sonnet만큼 뛰어난 코딩 능력을 갖추고 있습니다.

질문: Claude와 GLM을 어떻게 함께 작동하게 할 수 있을까요?

답변: Claude Bridge입니다. 공유 작업 대기열을 통해 두 모델을 조정하는 MCP 서버입니다.

┌─────────────────────────┐                    ┌─────────────────────────┐
│   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        │
└─────────────────────────┘                    └─────────────────────────┘

간단한 예시

터미널 1 (Opus): "JWT 인증 구현 작업을 대기열에 추가해줘"

터미널 2 (GLM): "다음 작업을 가져와" → 구현 수행 → "작업 완료"

터미널 1: "실행자가 무엇을 완료했나요?" → 결과 검토

주요 기능

• 작업 대기열 — 우선순위, 종속성 및 카테고리 기반 관리

• 공유 상태 — 프로젝트의 초점과 결정 사항을 양쪽 모두에서 확인 가능

• 세션 컨텍스트 — 중단한 지점부터 이어서 작업 가능

• 명확화 요청 — 실행자가 질문하고 설계자가 응답하는 구조

• 토큰 효율성 — Opus 사용량을 최소화하도록 설계

사용을 권장하지 않는 경우

Get-Shit-Done (GSD)와 같은 계획 프레임워크를 사용 중이라면 이 브릿지가 필요하지 않습니다. GSD와 같은 프레임워크는 두 터미널에서 직접 읽을 수 있는 프로젝트 파일(.planning/)에 컨텍스트를 저장합니다. /gsd:plan-phase 및 /gsd:execute-phase와 같은 슬래시 명령은 어떤 터미널에서든 작동합니다.

다음과 같은 경우 Claude Bridge를 사용하세요:

• 임시 작업, 빠른 수정, 일회성 연구

• 계획 프레임워크가 없는 프로젝트

• 재시작 시에도 세션 연속성이 필요한 경우

다음과 같은 경우 브릿지를 건너뛰세요:

• GSD 또는 유사한 파일 기반 계획 프레임워크를 사용하는 경우

• 두 터미널이 프로젝트 파일 시스템을 공유하는 경우

사전 요구 사항

• Node.js 18+ — 다운로드

• Claude Code CLI — 설치

• Z.ai 계정 — GLM 액세스용 (z.ai)

• 두 개의 터미널 창

터미널 프로필 설정

두 터미널에서 동일한 구독을 사용하시나요? 각 터미널에서 claude를 실행하기만 하면 되며, 별도의 프로필 설정은 필요하지 않습니다.

Claude + Z.ai GLM을 사용하시나요? 셸 프로필에 다음 함수를 추가하세요:

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 또는 ~/.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)"
}

사용법:

• 터미널 1: claude 실행 (Claude 구독 사용)

• 터미널 2: use-glm 실행 후 claude 실행 (Z.ai API 사용)

전체 설정 세부 정보는 GUIDE.md를 참조하세요.

빠른 시작

# 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

문서

GUIDE.md — 전체 설정, 터미널 구성, 사용법 및 문제 해결

다른 MCP 클라이언트와의 호환성

Claude + GLM을 위해 설계되었지만, 이 브릿지는 표준 MCP 서버이므로 MCP 호환 CLI라면 무엇이든 작동합니다:

• 두 개의 Claude Code 인스턴스 (동일하거나 다른 구독)

• Gemini CLI

• OpenCode

• Qwen Code

• 기타 모든 MCP 클라이언트

보안

Claude Bridge는 실제 API 토큰을 보유한 두 CLI 사이에 위치합니다. 명확히 해야 할 세 가지 사항이 있습니다.

• API 토큰은 브릿지를 통과하지 않습니다. 서버의 프로토콜은 작업, 상태 및 결과만 전달하며 자격 증명은 전달하지 않습니다. 각 터미널은 자체 제공업체에 직접 인증합니다(한쪽은 Claude 구독, 다른 쪽은 Z.ai 키). 사전 요구 사항의 셸 프로필 패턴은 터미널 세션이 ANTHROPIC_AUTH_TOKEN을 설정하도록 하기 위한 것이며, 브릿지는 이를 읽지 않습니다.

• use-glm에 키를 직접 입력하여 커밋하지 마세요. 이 README와 GUIDE.md의 셸 프로필 스니펫은 자리 표시자를 사용합니다. 이를 ${ZAI_API_KEY} 등으로 바꾸고 비밀번호 관리자나 시스템 키체인에서 비밀 값을 로드하세요. ~/.bashrc에 키를 직접 입력하는 것은 홈 디렉토리의 모든 백업에 키를 남기는 것과 같습니다.

• 공유 작업 대기열은 브릿지 프로세스 내에서 로컬로 유지됩니다. 작업, 명확화 요청 및 검토자 메모는 브릿지의 메모리 내 상태에 저장됩니다. 관련 없는 두 프로젝트를 동일한 브릿지 인스턴스에 연결하지 마세요. 대기열은 설계상 단일 테넌트입니다.

팀 단위로 사용할 경우, 각 설계자+실행자 터미널 쌍은 자체 브릿지 프로세스를 실행해야 하며 공유해서는 안 됩니다. MCP 전송은 로컬 머신의 stdio를 사용하며, 네트워크 포트에서 수신 대기하는 것은 없습니다.

라이선스

MIT — LICENSE를 참조하세요.

감사의 말

• Anthropic의 Claude Code를 위해 제작됨

• Z.ai GLM 통합을 위해 설계됨