Claude Bridge

Claude CodeとZ.aiのGLMモデルの連携を可能にするMCPサーバーです。Claude Opusを計画に、GLMを実装に使用します。

Claude CodeとZ.aiのGLMの強みを1つのワークフローに統合します。このMCPサーバーを使用すると、Opusが高レベルな計画を担当し、GLMが実装を担当します。これらは共有タスクキューを通じて調整され、別々のターミナルで同時に実行されます。アーキテクチャにはMaxサブスクリプションまたはAPIでClaude Codeを実行し、実行にはZ.ai (GLM) でClaude Codeを実行することで、両方を同時に連携させることができます。

目次

• なぜこれが必要なのか

• 簡単な例

• 機能

• 使用すべきでない場合

• 前提条件

• クイックスタート

• ドキュメント

• 他のMCPクライアントとの連携

• セキュリティ

• ライセンス

Related MCP server: Herald

なぜこれが必要なのか

Claudeのサブスクリプションを利用していても、制限に達してしまうことがあります。2つ目の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)

• 2つのターミナルウィンドウ

ターミナルプロファイルの設定

両方のターミナルで同じサブスクリプションを使用する場合: 各ターミナルで 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であれば何でも動作します:

• 2つのClaude Codeインスタンス (同じまたは異なるサブスクリプション)

• Gemini CLI

• OpenCode

• Qwen Code

• その他のMCPクライアント

セキュリティ

Claude Bridgeは、実際のAPIトークンを保持する2つのCLIの間に位置します。明確にしておくべき3つの点があります。

• APIトークンがブリッジを通過することはありません。 サーバーのプロトコルはタスク、ステータス、結果を伝送しますが、認証情報は伝送しません。各ターミナルはそれぞれのプロバイダーに対して直接認証を行います（片側はClaudeサブスクリプション、もう片側はZ.aiキー）。前提条件のシェルプロファイルパターンは、ターミナルセッションが ANTHROPIC_AUTH_TOKEN を設定するために使用されるもので、ブリッジがそれを読み取ることはありません。

• use-glm にキーを直接記述してコミットしないでください。 このREADMEと GUIDE.md のシェルプロファイルスニペットはプレースホルダーを使用しています。これを ${ZAI_API_KEY} などに置き換え、パスワードマネージャーやシステムキーチェーンからシークレットを読み込むようにしてください。~/.bashrc にキーを直接記述すると、ホームディレクトリのすべてのバックアップにキーが含まれてしまいます。

• 共有タスクキューはブリッジプロセスに対してローカルです。 タスク、明確化、レビュー担当者のメモは、ブリッジのメモリ内状態に存在します。関連のない2つのプロジェクトを同じブリッジインスタンスに向けないでください。キューは設計上シングルテナントです。

チームで使用する場合、アーキテクトと実行者のターミナルの各ペアは、共有せずに独自のブリッジプロセスを実行する必要があります。MCPトランスポートはローカルマシンのstdioであり、ネットワークポートでリッスンするものはありません。

ライセンス

MIT — LICENSE を参照してください。

謝辞

• Anthropicによる Claude Code 用に構築

• Z.ai GLM統合用に設計