starbaser/ccproxy

Build mods for Claude Code: Hook any request, modify any response, /model "with-your-custom-model", intelligent model routing using your logic or ours

What it solves

ccproxy は LLM ツールと AI 活用のために設計されたネットワークインターセプターです。開発者は LLM クライアント（Aider、Cursor、OpenAI SDK など）と AI プロバイダー（Anthropic、Gemini、OpenAI、DeepSeek など）間のトラフィックを捕捉、検査、変換できます。TLS の完全な検査とリアルタイムでのリクエスト・レスポンスの再ルーティングや変更機能により、"ブラックボックス" の LLM API 呼び出し問題を解決します。

How it works

このツールは透明プロキシとして動作し、主に以下の 2 つのインターセプション手法を使用します。

  1. Reverse Proxy: ポート 4000 でリスナーを起動し、クライアントは環境変数（例: ANTHROPIC_BASE_URL）でこのポートを指すことができます。
  2. WireGuard Namespace Jail: ルートレスの Linux ネットワーク名前空間で、プロセスの SDK 設定に関わらずすべてのアウトバウンドトラフィックを捕捉します。

トラフィックは DAG 駆動の hook パイプライン（インバウンド・アウトバウンド）と lightllm と呼ばれる変換レイヤーを通過します。このレイヤーはストリーミング FSM を用いて、プロバイダー間のワイヤーフォーマット変換（例: Anthropic 形式のリクエストを Gemini 形式に変換）を行います。

Who it’s for

LLM API のやり取りをデバッグしたり、プロバイダー横断ルーティングを実装したり、既存の LLM クライアントに未対応機能（MCP サンプリングなど）を追加したい AI 開発者や上級ユーザー向けです。

Highlights

  • Cross-Provider Routing: Anthropic、Gemini、OpenAI、DeepSeek など主要プロバイダー間でリクエストをリダイレクトまたは変換。
  • Transparent Capture: WireGuard 名前空間を使用し、クライアント SDK の設定変更なしでトラフィックを捕捉。
  • Flow Inspection: 組み込み CLI ツールで jq フィルタを使い、クライアントリクエストと転送リクエストを一覧、ダンプ、比較可能。
  • MCP Bridging: 任意のクライアントに Model Context Protocol（MCP）機能（サンプリングやサーバ通知）を追加。
  • OAuth Integration: Anthropic、Google、Codex の OAuth リフレッシュをプロセス内で実行し、公式 CLI と認証情報を共有可能。
  • Request Shaping: サニタイズされたリクエストエンベロープを再生し、特定プロバイダー向けに ID ヘッダーとコンプライアンスを保持。