cc-gateway — What is it?

CC Gateway is an AI API identity gateway that normalizes device fingerprints and telemetry to protect user privacy and control data exposure in API proxying.

⭐ 364 Stars 🍴 58 Forks TypeScript Author: motiful
Source: per README View on GitHub →

Why it matters

CC Gateway is gaining attention for addressing privacy concerns in AI API usage by normalizing device identities and environment fingerprints, providing a solution for users who want to control their data exposure without modifying their existing setup. Its unique technical choice is the comprehensive normalization of various identity and environment dimensions, which is not commonly found in similar tools.

Source: Synthesis of README and project traits

Core Features

Full identity rewrite

Rewrites device ID, email, session metadata, and the `user_id` JSON blob in every API request to a single canonical identity, ensuring consistent representation across all interactions.

Source: per README
Environment dimensions replacement

Replaces over 40 environment dimensions, including platform, architecture, Node.js version, terminal, package managers, and runtimes, to prevent device-specific information from being exposed.

Source: per README
System prompt sanitization

Rewrites system prompts to match the canonical profile, ensuring that no sensitive information is inadvertently included in prompts sent to the API.

Source: per README
Billing header stripping

Removes the `x-anthropic-billing-header` to prevent billing information from being transmitted and to enable cross-session prompt cache sharing, reducing costs.

Source: per README
Process metrics normalization

Normalizes process metrics such as physical RAM, heap size, and RSS to canonical values to prevent hardware differences from leaking.

Source: per README
Zero-login client setup

Provides a single launcher script for clients, eliminating the need for browser OAuth, configuration changes, or additional files.

Source: per README
Centralized OAuth

Manages token refresh internally, ensuring that client machines never contact `platform.claude.com` directly.

Source: per README
Instant startup

Uses existing access tokens on launch and refreshes them silently, ensuring no network calls until necessary.

Source: per README
Proxy-aware

Supports `HTTPS_PROXY` and `HTTP_PROXY` environment variables for outbound connections, allowing integration with proxy tools like Clash or V2Ray.

Source: per README
Telemetry leak prevention

Strips fields like `baseUrl` and `gateway` that could reveal proxy usage in analytics events, enhancing privacy.

Source: per README

Architecture

The architecture of CC Gateway involves a client-side launcher that communicates with a central gateway server. The gateway server handles authentication, token management, and data normalization before forwarding requests to the Anthropic API. It uses TypeScript for development, with dependencies on `https-proxy-agent` and `yaml` for proxying and configuration management. The project utilizes Docker for deployment and includes scripts for setup and client management.

Source: Code tree + dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) https-proxy-agenthttps-proxy-ag… yaml Full identity rewriteFull identity rewri… Environment dimensions replacementEnvironment dimensi… System prompt sanitizationSystem prompt sanit… Billing header strippingBilling header stri… Process metrics normalizationProcess metrics nor… Zero-login client setupZero-login client s… Centralized OAuth Instant startup cc-gateway Project Core feature Key dependency

Center: project; inner ring: core feature modules; outer ring: key dependencies. Auto-generated from core_features and tech_stack.key_deps.

Tech Stack

LanguageTypeScriptFrameworkNone explicitly mentioned, but TypeScript is used for development
https-proxy-agentyaml
Docker
Source: Dependency files + code tree

Quick Start

git clone https://github.com/motiful/cc-gateway.git cd cc-gateway npm install bash scripts/quick-setup.sh ./clients/cc-<hostname>
Source: README Installation/Quick Start

Use Cases

CC Gateway is suitable for users and organizations that require privacy-preserving API proxying, such as those using AI APIs and needing to control the exposure of device and environment information. It is particularly useful in scenarios where multiple devices are used and there is a need to maintain a consistent identity across sessions.

Source: README

Strengths & Limitations

Strengths

  • Strength 1: Comprehensive normalization of identity and environment dimensions to protect user privacy.
  • Strength 2: Easy to set up and use with zero-login client setup and centralized OAuth management.
  • Strength 3: Supports proxy integration for enhanced privacy and flexibility.

Limitations

  • Limitation 1: The project is still in alpha stage and may have bugs or limitations.
  • Limitation 2: The lack of detailed documentation may make it challenging for new users to understand and implement.
Source: Synthesis of README, code structure and dependencies

Latest Release

0.2.0 (no release date provided, no summary of changes)

Source: GitHub Releases

Verdict

CC Gateway is a promising project for those seeking to enhance privacy in AI API usage. Its comprehensive approach to data normalization and ease of setup make it a valuable tool for users and organizations concerned about data exposure. However, its alpha status and potential lack of documentation may be barriers for some users.

Transparency Notice
This page is auto-generated by AI (a large language model) from the following public materials: GitHub README, code tree, dependency files and release notes. Analyzed at: 2026-05-23 19:05. Quality score: 85/100.

Data sources: README, GitHub API, dependency files