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 기반 훅 파이프라인(인바운드·아웃바운드)과 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 헤더와 컴플라이언스를 유지.