ccproxy

ccproxy — CLI Proxy
Discord

ccproxy is a transparent network interceptor for LLM tooling and AI harnesses,
built on mitmproxy and WireGuard with full TLS inspection and Wireshark keylog
export. Originally purpose-built for Claude Code, ccproxy now works with any LLM
client: Aider, Cursor, OpenAI SDK, or anything else that speaks HTTP. It jails a
process inside a rootless WireGuard namespace, intercepts at the network layer,
and feeds it through a DAG-driven pipeline that can decompose, transform, and
re-route traffic between providers.
Cross-provider request and response transformation is handled by lightllm, a
surgical adapter and streaming-FSM layer inside ccproxy — no LiteLLM proxy
subprocess, no gateway server.

New in 2.0: Codex/OpenAI Responses support with packaged request shaping,
plus DeepSeek V4 routing for Anthropic-format requests through DeepSeek's
/anthropic/v1/messages endpoint. See Configuration for
the routing setup.

The hook pipeline is your extension point for building mods and taking control
of your LLM usage while respecting terms of service:
- Cross-provider routing: redirect or transform requests between Anthropic,
  Gemini, OpenAI, DeepSeek, Perplexity Pro, and Anthropic-compatible forks.
- Compliance shaping: replay packaged, sanitized SDK compliance envelopes
  for built-in providers while injecting your actual request content at runtime.
- MCP bridging: add unsupported MCP features to any client:
  sampling
  via sentinel key detection,
  server notifications
  bridged into the LLM context via ccproxy’s /mcp endpoint, and experimental
  tasks
  support.
Feedback and contributions welcome —
open an issue or submit a PR.

Installation

Platform support

WSL2 is fully supported because it *is* Linux. Native Windows is not — use WSL2.
On macOS,…