by CaddyGlow
is a local reverse proxy providing unified access to multiple AI providers (Claude, Codex) through a single interface, using your existing subscriptions without API key billing.
# Add to your Claude Code skills
git clone https://github.com/CaddyGlow/ccproxy-apiCCProxy is a local, plugin-based reverse proxy that unifies access to multiple AI providers (e.g., Claude SDK/API and OpenAI Codex) behind a consistent API. It ships with bundled plugins for providers, logging, tracing, metrics, analytics, and more.
Each provider adapter exposes the same surface area: OpenAI Chat
Completions, OpenAI Responses, and Anthropic Messages. The proxy maintains a
shared model-mapping layer so you can reuse the same model identifier
across providers without rewriting client code.
Authentication can reuse existing provider files (e.g., Claude CLI SDK
tokens and the Codex CLI credential store), or you can run
ccproxy auth login <provider> to complete the OAuth flow from the CLI;
stored secrets are picked up automatically by the proxy.
CCProxy's plugin system lets you add instrumentation and storage layers without patching the core server. Bundled plugins currently include:
access_log: structured access
logging for client and provider trafficanalytics: DuckDB-backed analytics
APIs for captured request logsclaude_api: Anthropic Claude HTTP
API adapter with health and metricsclaude_sdk: local Claude CLI/SDK
adapter with session poolingNo comments yet. Be the first to share your thoughts!
command_replay: generates
curl/xh commands for captured requestscopilot: GitHub Copilot provider
adapter with OAuth token managementcredential_balancer:
rotates upstream credentials based on healthdashboard: serves the CCProxy
dashboard SPA and APIsdocker: runs providers inside Docker via
CLI extensionsduckdb_storage: exposes
DuckDB-backed storage for logs and analyticsmax_tokens: normalizes
max_tokens fields to provider limitsmetrics: Prometheus-compatible metrics
with optional Pushgatewayoauth_claude: standalone OAuth
provider for Claude integrationsoauth_codex: standalone OAuth
provider for Codex integrationspermissions: interactive approval
flow for privileged tool actionspricing: caches model pricing data for
cost-aware featuresrequest_tracer: detailed
request/response tracing for debuggingShared helpers such as
claude_shared provide metadata
consumed by the Claude plugins. Each plugin directory contains its own README
with configuration examples.
docs/index.mddocs/getting-started/quickstart.mddocs/getting-started/configuration.mddocs/examples.mddocs/migration/0.2-plugin-first.mdThe plugin system is enabled by default (enable_plugins = true), and all
discovered plugins load automatically when no additional filters are set. Use
these knobs to adjust what runs:
enabled_plugins: optional allow list; when set, only the listed plugins run.disabled_plugins: optional block list applied when enabled_plugins is not
set.plugins.<name>.enabled: per-plugin flag (defaults to true) that you can
override in TOML or environment variables. Any plugin set to false is added
to the deny list alongside disabled_plugins during startup.During startup we merge disabled_plugins and any plugins.<name>.enabled = false
entries into a single deny list. At runtime the loader checks the allow list
first and then confirms the plugin is not deny listed. Configure plugins under
plugins.<name> in TOML or via nested environment variables.
Use ccproxy plugins list to inspect discovered plugins and
ccproxy plugins settings <name> to review configuration fields.
.ccproxy.toml)enable_plugins = true
# enabled_plugins = ["metrics", "analytics"] # Optional allow list
disabled_plugins = ["duckdb_storage"] # Optional block list
[plugins.access_log]
client_enabled = true
client_format = "structured"
client_log_file = "/tmp/ccproxy/access.log"
[plugins.request_tracer]
json_logs_enabled = true
raw_http_enabled = true
log_dir = "/tmp/ccproxy/traces"
[plugins.duckdb_storage]
enabled = false
[plugins.analytics]
enabled = true
# Metrics plugin
[plugins.metrics]
enabled = true
# pushgateway_enabled = true
# pushgateway_url = "http://localhost:9091"
# pushgateway_job = "ccproxy"
# pushgateway_push_interval = 60
__)export DISABLED_PLUGINS="duckdb_storage" # Optional block list
export PLUGINS__ACCESS_LOG__ENABLED=true
export PLUGINS__ACCESS_LOG__CLIENT_ENABLED=true
export PLUGINS__ACCESS_LOG__CLIENT_FORMAT=structured
export PLUGINS__ACCESS_LOG__CLIENT_LOG_FILE=/tmp/ccproxy/access.log
export PLUGINS__REQUEST_TRACER__ENABLED=true
export PLUGINS__REQUEST_TRACER__JSON_LOGS_ENABLED=true
export PLUGINS__REQUEST_TRACER__RAW_HTTP_ENABLED=true
export PLUGINS__REQUEST_TRACER__LOG_DIR=/tmp/ccproxy/traces
export PLUGINS__DUCKDB_STORAGE__ENABLED=true
export PLUGINS__ANALYTICS__ENABLED=true
export PLUGINS__METRICS__ENABLED=true
# export PLUGINS__METRICS__PUSHGATEWAY_ENABLED=true
# export PLUGINS__METRICS__PUSHGATEWAY_URL=http://localhost:9091
To install the latest stable release without cloning the repository, use uvx
to grab the published wheel and launch the CLI:
uvx --with "ccproxy-api[all]" ccproxy serve --port 8000
If you prefer pipx, install the package (optionally with extras) and use the
local shim:
pipx install "ccproxy-api[all]"
ccproxy serve # default on localhost:8000
See LICENSE.