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

此工具以透明代理的方式運作，主要透過兩種攔截方法：

  1. Reverse Proxy：在 4000 埠上監聽，客戶端可透過環境變數（例如 ANTHROPIC_BASE_URL）指向此端口。
  2. WireGuard Namespace Jail：一個無根 Linux 網路命名空間，能捕獲來自任意程序的所有外發流量，無論其 SDK 設定為何。

流量會通過 DAG 驅動的 hook pipeline（進入與離開）以及名為 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：重放已清理的請求封裝，以保留身份標頭並符合特定供應商的合規要求。