# cc-gateway-ai-proxy

Guides deployment of CC Gateway, a proxy that routes Claude Code traffic through one gateway and standardizes device telemetry. Useful across multiple machines.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 713 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/cc-gateway-ai-proxy/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/cc-gateway-ai-proxy

## What it does

This skill guides setup of CC Gateway, a TypeScript reverse proxy placed between Claude Code and the Anthropic API. The gateway replaces more than 40 fingerprint fields with one configured identity, injects OAuth authentication, and forwards SSE responses. Environment settings and Clash rules cover client routing and direct-connection blocking.

The guide covers `npm` installation, identity and client-token generation, OAuth extraction on macOS, `config.yaml` editing, and startup with `npm` or Docker Compose. Health and rewrite checks use `/_health` and `/_verify`; client setup can run through `scripts/client-setup.sh`. Node.js 18+ or Docker is required to deploy the gateway.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill cc-gateway-ai-proxy -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cc-gateway-ai-proxy/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cc-gateway-ai-proxy/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill cc-gateway-ai-proxy -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cc-gateway-ai-proxy/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill cc-gateway-ai-proxy -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cc-gateway-ai-proxy/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills cc-gateway-ai-proxy
```

2. **Manually: put the files in place**
- File: `.github/skills/cc-gateway-ai-proxy/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill cc-gateway-ai-proxy -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/cc-gateway-ai-proxy
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cc-gateway-ai-proxy/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill cc-gateway-ai-proxy -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/cc-gateway-ai-proxy/SKILL.md

## When to use it
- route Claude Code traffic through a reverse proxy
- normalize identities across several machines
- centralize OAuth token refresh
- block direct Anthropic connections
- inspect request rewriting at the gateway

## Example prompts
- Set up CC Gateway for Claude Code with OAuth authentication and client tokens.
- Create `config.yaml`, generate one identity, and add tokens for `my-laptop` and `work-desktop`.
- Configure a client with `scripts/client-setup.sh`, then check `/_health` and `/_verify`.

## Similar
- [reverse-proxy](https://affpapa.org/en/nevibecode/skills/reverse-proxy.md) — skill · 473 installs
- [MCP Gateway](https://affpapa.org/en/nevibecode/mcp/panossalt-mcp-gateway.md) — MCP server · ★ 6
- [cortex-gateway](https://affpapa.org/en/nevibecode/mcp/cortex-gateway.md) — MCP server · ★ 12
- [api-gateway](https://affpapa.org/en/nevibecode/skills/api-gateway.md) — skill · 1300 installs
- [nginx-expert](https://affpapa.org/en/nevibecode/skills/nginx-expert.md) — skill · 437 installs
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 186 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md